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Preface 

This book is designed to be a quick reference 
guide to the BASIC languages used on the Radio 
Shack computer systems. It covers the TRS-80 
Model I, Model II, Model 12, Model III, Model 4and 
4P, Color Computer, MC-10, and Model 100. It 
won't replace the BASIC manuals that come with 
those systems, but it will help to jog your memory 
about the types of BASIC commands that are 
available, the format of the commands, the opera- 
tion of the commands, and the commands that are 
related. 

The commands described here include all 
BASIC symbols, such as / for divide, all BASIC 
"commands',' such as PRINT, and all BASIC "func- 
tions',' such as ATN. We'll use the generic term 
"command" to mean any of these three items. The 
term "statement" will be used to describe any use 
of the commands in a single step, such as 
A=SIN(B/C) or POKE 16523,(RR/67). The term 
"line" will mean a single statement or multiple 
statements with the same line number. 

There are 31 7 commands in this reference book, 
one per page. They are organized in alphabetical 
order. The Contents section on the next few pages 
lists all commands and indicates for which systems 
they are used. The systems are: 

® Model I, Level I BASIC 

© Model I, Level II BASIC 

• Model I, Disk BASIC 

• Model ll/Model 12 BASIC 

• Model III, Level I BASIC 

• Model III, Level III 

(Model 4, 4P in III mode) 

• Model III, Disk BASIC 

(Model 4, 4P in III mode) 

• Model 4, Model 4P Disk BASIC 

• Color Computer, basic BASIC 

• Color Computer, Extended BASIC 

• Color Computer, Disk BASIC 

• MC-10 BASIC 

• Model 100 BASIC 

• Model 100, Disk BASIC 



We'll keep this order in the SYSTEM description 
on each page. 

Each command format is described under 
"FORMAT'.' In those cases where the command is 
normally used in a program, we've included "line#" 
under the format. In those cases where the com- 
mand is normally used in the command mode, 
we've left out the "line#'.' In some cases the com- 
mand is used in either the command mode or pro- 
gram execution, and we've indicated both by two 
or more format statements, one with "line#" and 
one without. 

In those cases where a command requires paren- 
theses, double quotes, or other characters, we've 
included them in the FORMAT. Dots indicate that 
the command may be embedded in other com- 
mands and probably won't stand by itself, as in the 
case of functions. 

Model 4 and 4P users note that BASIC requires a 
space after most BASIC keywords. If you see a 
"Syntax error" on the screen, there's a good 
chance you've forgotten a space after a command. 

The EXAM PLES show one or more actual exam- 
ples of the use of the command. Descriptive text is 
sometimes included in lowercase in the right-hand 
portion of the examples. 

The DESCRIPTION section contains a very brief 
explanation of the command. Any peculiarities for 
specific systems are also described here. 

RELATED COMMANDS lists any commands 
that may help in understanding the action of the 
command in question. 

To Babbage for starting the whole thing! 
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SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

linett... variable name* . . . 

EXAMPLES 

1000 ft! =123456 
1010 ZZ! =99993 

DESCRIPTION 

The suffix " !" is used to define single-precision 
variables. The default variable type is single 
precision, but the "!" suffix can be used to define 
a variable within a range used on a DEFDBL, 
DEFINT, or DEFSTR. Single-precision variables 
hold 7 decimal digits of precision in memory and 
display 6 decimal digits. Single-precision variables 
take up four bytes of RAM storage for each variable. 

RELATED COMMANDS 

DEFDBL, DEFINT, DEFSNG, DEFSTR 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
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Model 100 
Model 100, Disk 



FORMAT 

linett... "string literal".,. 

EXAMPLES 

1000 fl$="THIS IS fl STRING" 

DESCRIPTION 

Double quotes are used to enclose string "literals". 
String literals are the actual text of the string. They 
are stored in the BASIC program line itself, 
although they may be used to create new strings 
that are stored in the string storage area. String 
literals may generally be used any time that a string 
variable can be used, such as in PRINT 
statements, string comparisons, or other string 
processing. Always enclose the string literal with 
double quotes; failure to do so may cause errors in 
program renumbering or other program processing. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 

I, LVL II « 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL III (4,4P)« 
III, Disk (4, 4P) • 
4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC ' ~T - ™"_, rr -n \ 

CC, Disk ;-■. " -~ I-"." 1 . - \— i. -\f, 

MC-10 j-"'* S .:--.' . -"-- i .' -v- 

Model 100 • f — " 

Model 100, Disk • l 

FORMAT 

lineti... variable namett . . . 

EXAMPLES 

1000 Rtt=1234567890. 1234567 
1010 ZZ8=99999999999 

DESCRIPTION 

The suffix "8" is used to define double-precision 
variables. The default variable type is single 
precision. Other numeric variable types must be 
defined by the %, #, D, or $ suffixes, or by 
DEFINT, DEFDBL, or DEFSTR. The "8" suffix 
can be used to define a double-precision variable 
within a range used on a DEFINT, DEFDBL, or 
DEFSTR. Double-precision variables hold 17 
decimal digits of precision in memory and display 
16 decimal digits (14 digits in Model 100). 
Double-precision variables take up eight bytes of 
RAM storage for each variable. Double-precision 
variables should be used in place of single-precision 
variables where extreme accuracy is desired and 
when the number of double-precision variables will 
not be prohibitively large (as would be the case in a 
large array). 

RELATED COMMANDS 

DEFDBL. DEFINT, DEFSNG, DEFSTR 




SYSTEM 

I, LVL I 

I, LVL II * 

I, Disk • 

II, 12 • 

III, LVL I ° 
III, LVL III (4, 4P)« 
III, Disk (4, 4P) • 
4, 4P, Disk « 
CC, BASIC » 
CC, Ext BASIC • 
CC, Disk • 
MC-10 o 
Model 100 • 
Model 100, Disk » 

FORMAT 

linett... variable names. . . 

EXAMPLES 

1000 H$=" TELEPHONE 8" 
1010 ZZ$=STRING$(100, "*" ) 

DESCRIPTION 

The suffix "$" is used to define string variables. 
String variables generally hold ASCII character data, 
although they may hold other non-ASCII data as 
well. String variables may be from to 255 
characters long, where each character corresponds 
to one byte in RAM. The names of string variables 
follow the same rules for numeric variable names. 
The first character must be alphabetic. (Model l/lll 
Level I allows only A$ and B$.) The suffix "$" 
denotes the variable as a string variable; the same 
name may be used for a numeric and string 
variable, except that the suffix will be different. AA$ 
and AA are a string variable and numeric variable, 
respectively. The suffix "$" may be used to define a 
string variable within a range of other variables 
defined by a DEFDBL, DEFSNG, or DEFINT. 

RELATED COMMANDS 

DEFDBL, DEFINT, DEFSNG, DEFSTR 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II. LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

lineti... variable name%. . . 

EXAMPLES 

1000 F\%=- 12345 
1010 ZZ?^=9999 

DESCRIPTION 

The suffix "%" is used to define integer variables. 
The default variable type is single precision, but the 
"%" suffix can be used to define an integer variable 
explicitly or within a range used on a DEFDBL, 
DEFSNG, or DEFSTR. Integer variables hold 
values from -32768 through +32767. No fractions 
are allowed. Integer variables take up two bytes of 
RAM storage for each variable, making them one of 
the most efficient ways to store data, when the data 
is in the limited range of values. 

RELATED COMMANDS 

DEFDBL, DEFINT, DEFSNG, DEFSTR 



SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

line#...mdddd... 

EXAMPLES 

1010 FOR I=&H8000 TO &H8003 set up loop 
1010 PRINT PEEI<( I ) display contents 
1020 NEXT I continue 

DESCRIPTION 

The prefix "&H" is a special code that indicates 
"hexadecimal digits following'.' Hexadecimal notation 
is used in place of decimal or binary notation for 
Z-80 instruction codes, data relating to machine- 
language operation, and system addresses. The &H 
prefix may be followed by 1 to 4 hexadecimal digits. 
Each hexadecimal digit is through 9 or A through 
F and represents a power of 16. The maximum 
hexadecimal value that can be defined in TRS-80 
systems is &HFFFF, representing binary 
1111111111111111, or decimal 65,535. 

RELATED COMMANDS 

None 



SYSTEM 



I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVLI 

IN, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

line#...mdddddd... 

EXAMPLES 

1010 FOR I=&O100000 TO &O100003 setup 

loop 

1020 PRINT PEEK f 1 1 print contents 

1030 NEXT I loop 

DESCRIPTION 

The prefix "&o" is a special code that indicates 
"octal digits following'.' Octal notation is sometimes 
(rarely) used in place of decimal or binary notation 
for Z-80 instruction codes, data relating to machine- 
language operation, and system addresses. The &o 
prefix may be followed by 1 to 6 octal digits. Each 
octal digit is through 7 and represents a power of 
8. The maximum octal value that can be defined in 
TRS-80 systems is &0 177777, equivalent to binary 
1111111111111111, or decimal 65535. The prefix 
"&" is equivalent to "&o" and may be used in its 
place. 

RELATED COMMANDS 

None 



SYSTEM 



I, LVL I • 

I, LVL II o 

I, Disk « 

II, 12 * 

III, LVL I 

III, LVL III (4, 4P)® 

III, Disk (4, 4P) * 

4, 4P, Disk ® 

CC, BASIC * 

CC, Ext BASIC * 

CC, Disk ® 
MC-10 

Model 100 ® 

Model 100, Disk ® 

FORMAT 

//V?e# ' remar/c fexf 
//ne# ...'remark text... 




EXAMPLES 

1000 'THIS IS A REMARK LINE 
1010 R=B 'RND SO IS THIS PORTION 

DESCRIPTION 

The single quote replaces the colon (:), REM 
commands. In effect, it is a shorthand way of 
creating a new REM statement, either at the 
beginning of a line or in the middle of a line. Usin£ 
the single quote creates "pretty" listings that may 
be much more readable. The single quote may be 
placed anywhere in the line. 

RELATED COMMANDS 

REM 



SYSTEM 

, LVL I • 

, LVL II » 

, Disk • 

I, 12 * 

II, LVL I 

II. LVL III (4, 4P) » 

II, Disk (4, 4P) « 

4, 4P, Disk * 

CC, BASIC • 
CC, Ext BASIC 

CC, Disk • 

MC-10 • 

Model 100 • 

Model 100, Disk » 
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FORMAT 

//'ne# ...(...)... 

EXAMPLES 

1000 A=B/(C+D) 

DESCRIPTION 

Parentheses are used to denote the order of 
operations in expressions. In the example above, the 
result should be B/(C+D); if the parentheses were 
not included the operation would become B/C, 
followed by the addition of D. BASIC always 
evaluates the expressions inside parentheses before 
evaluating the rest of the expression. Parentheses 
may be "nested" that is, there may be many levels 
of parentheses, one within another. BASIC always 
works from the innermost parentheses out in 
evaluating parentheses. 

RELATED COMMANDS 

None 



SYSTEM 
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Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 
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FORMAT 

linett...*... 

EXAMPLES 

1000 C=3 . 14159*D find circumference 
1010 C=SQR(fl*A+B*B) find length of 
hypotenuse 

DESCRIPTION 

The special character "*" is reserved as a BfiSIC 
operator signifying multiplication, except for the 
Model l/lll Level I, where it is also a logical "AND" 
operator. It should not be used in variable names or 
in any other context other than within text strings 
enclosed by quotes. "*" may be used any number 
of times within a BASIC statement as long as it is 
not immediately followed by another operator. 

RELATED COMMANDS 

*(AND) 




SYSTEM 

I, LVL I « 

I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC e^r — - -— w--^~ ---^ , 

CC, Disk . - ""■- "" 

MC-10 'jl' :l":- 1- ." '"" --"*: ';'- - '-;, 
Model 100 •*— ^^--J^- : K-,v:- •■ j,-. 
Model 100, Disk «■ ^'^=-- =— ^ 

FORMAT 

line#...(expression) * (expression)... 
EXAMPLES 

1000 IF (A<2) * (B>5) THEN PRINT 

"HELP!" 

1010 IF A * 3=3 THEN GOTO 8000 

DESCRIPTION 

In the Model l/lll Level I, "*" is an abbreviation for 
the AND function in addition to representing a 
multiplication operator. AND is used as a relational 
operator and for bit manipulation. In the first use, 
AND compares two constants, variables, or 
expressions. If both expressions are true, then the 
AND function is true. In the example above, 
(A<2) * (B>5] is true only if variable A is 
less than 2 AND variable B is greater than 5. The 
THEN action would only be taken if both 
expressions were true (expression 1 AND expression 
2). In the bit manipulation case, AND is used to 
logically AND integer variable bits, considered to be 
binary numbers. An AND of binary values produces 
a 1 for each bit position only if both operands have 
a 1 bit in that bit position. An AND of the two 
binary values 10100000 and 11001111 would 
produce a result of 10000000. The AND in this 
application can be used to test bits, mask out fields, 
and perform other bit-wise operations. 
RELATED COMMANDS*, + (OR) 




SYSTEM 

, LVL I * 

, LVL II • 

, Disk • 

I, 12 • 

II, LVL I ® 
II, LVL III (4,4P)« 
II, Disk (4, 4P) • 

4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC » • -- - - .".:-- 

CC, Disk * 

MC-10 • 

Model 100 • 

Model 100, Disk • 

FORMAT 

line#...expression+expression... 
EXAMPLES 

1000 c=1.5+32+N+M find total 
DESCRIPTION 

The special character "+" is reserved as the sign of 
a constant or a BASIC operator signifying addition 
or string concatenation. (It is also used in the Model 
l/lll Level I to specify a logical "OR".) It should not 
be used in variable names or in any other context 
other than within text strings enclosed by quotes. 
"+" may be used any number of times within a 
BASIC statement as long as it is not immediately 
followed by another operator. When used as an 
arithmetic operator, it has the same effect as the 
usual "plus" sign - it adds two quantities, which 
may be any mixture of constants, variables, or 
expressions. When used as a string concatenation 
operator (not a Model l/lll Level I function), it joins 
two strings. The result string is made up of the first 
string appended by the second string. If A$="N0W 
IS THE TIMEti" and B$="F0R ALL GOOD 
PROGRAMMERS..',' then C$=A$+B$ would set C$ 
equal to "NOW IS THE TIME FOR ALL GOOD 
PROGRAMMERS..'.' When used as a sign, it must be 
immediately followed by numeric data. 
RELATED COMMANDS + (OR) 




SYSTEM 

I, LVL I • 

I, LVL II 

I, Disk 

II, 12 

III, LVL I • 
III, LVL III (4, 4P) 
III. Disk (4. 4P) 
4, 4P, Disk 

CC, BASIC , ...-_. 

CC, Ext BASIC 

CC, Disk , ;- 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

lineti... (expression) + (expression)... 

EXAMPLES 

1000 IF |'A<2] + ('B>5'] then print 
"HELP!''' 

1010 A=A + 8 set bit 3 
DESCRIPTION 

In the Model l/lll Level I, "+" is an abbreviation for 
the OR function along with representing an addition 
operator. OR is used as a relational operator and for 
bit manipulation. In the first use, OR compares two 
constants, variables, or expressions. If either 
expression is true, then the OR function is true. In 
the example above, (A<2) + (B>5] is true if 
variable A is less than 2 OR variable B is greater 
than 5. The THEN action would only be taken if 
either expressions was true (expression 1 + 
expression 2). In the bit manipulation case, OR is 
used to logically OR integer variable bits, considered 
to be binary numbers. An OR of binary values 
produces a 1 for each bit position if either operand 
has a 1 bit in that bit position. An OR of the two 
binary values 10100000 and 11001111 would 
produce a result of 11101111. The OR in this 
application can be used to test bits, set individual 
bits, and perform other bit-wise operations. 
RELATED COMMANDS 
«i:'ANDj, + 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I. 12 

II, LVL I 

II, LVL III (4, 4P)< 
II, Disk (4, 4P) ■ 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

//ne#...PR I NT iteml,item2,... 
//7?e#...LPRINT iteml,item2,... 

EXAMPLES 

1000 PRINT ft, 

1010 PRINT "NUMBER IS ";N,"NEXT 

IS ";M 

DESCRIPTION 

In addition to separating items in DATA lists and 
acting as a delimiter in certain BASIC commands, 
the comma has a special use in PRINT statements. 
It is used in PRINT and LPRINT statements to 
mean "tab to the next print zone'.' Both the video 
display and line printer lines are divided into "print 
zones" which are similar to predefined typewriter 
tabs. When a comma is encountered after a PRINT 
item, the BASIC interpreter will tab to the start of 
the next print zone. This allows for easy 
columnization of displayed and printed data items. 
The print zones are predefined and dependent upon 
the system used. 

RELATED COMMANDS 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

Ml, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 




FORMAT 

lineti. . . expression - expression.. . 

EXAMPLES 

1000 L=L - 1 - N find adjusted length 

DESCRIPTION 

The special character "-" is reserved as a BASIC 
operator signifying subtraction or for negating 
values. It should not be used in variable names or 
in any other context other than within text strings 
enclosed by quotes. When used as an arithmetic 
operator, "-" may be used any number of times 
within a BASIC statement as long as it is not 
immediately followed by another operator. Its 
meaning is identical to the normal use of the 
subtract sign. When used to negate quantities, it 
must be immediately followed by a numerical 
constant, as in 

1000 DATA -5, -67. 89, +45, +1 

RELATED COMMANDS 

None 



SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) ■ 
II, Disk (4, 4P) ■ 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk ■ 




FORMAT 

used in Edit mode 

EXAMPLES 

EDIT. 

DESCRIPTION 

The period is used in Edit mode to mean "the 
current line" The command EDIT, will result in an 
Edit of the current line number. If line 400 was 
LISTed just prior to the EDIT., for example, 
EDIT, will invoke an edit of line 400. 

RELATED COMMANDS 

None 



SYSTEM 

LVLI 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P)< 
I, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 




FORMAT 

linett. . . expression ■■■-' expression . . . 

EXAMPLES 

1000 R=2*D/3. 14159 find radians 
1010 TO=SL)f T 1/100 find average score 

DESCRIPTION 

The special character "/" is reserved as a BfiSIC 
operator signifying division. It should not be used in 
variable names or in any other context other than 
within text strings enclosed by quotes. " " may be 
used any number of times within a BfiSIC 
statement as long as it is not immediately followed 
by another operator. 

RELATED COMMANDS 
None 



SYSTEM 

I, LVL I • 

I, LVL II • 

I, Disk • 

II, 12 

III, LVL I * 
III, LVL III (4, 4P) • 
III, Disk (4, 4P) » 
4, 4P, Disk a 
CC, BASIC • 
CC, Ext BASIC « 
CC, Disk » 
MC-10 » 
Model 100 » 
Model 100, Disk • 




FORMAT 

line# ...:...:... 

EXAMPLES 

1000 A=C*2 : B=C*64 : C$=fi$ 'fi 
MULTIPLE-STfiTEMENT LINE 

DESCRIPTION 

The colon is used to create multiple-statement lines. 
A multiple-statement line, just as the name implies, 
has two or more separate statement groupings, with 
a common line number, as in the above example. All 
statements in the line will be executed in sequence, 
just as if they were separate lines. GOTOs or 
GOSUBs to the middle of the line, however, are not 
possible. When statements are appended to 
IF. . .THEN or IF. . .THEN. . .ELSE 
statements, the appended statements will not be 
executed unless the THEN or ELSE condition is 
satisfied. 1000 IF R=l THEN 8=0 : C=2 and 
1010 IF flOl THEN B=l ELSE B=0 : C=2 
will set C equal to 2 only if A=l (both cases). 

RELATED COMMANDS 

None i 




SYSTEM 

I, LVL I • 

I, LVL II • 

I, Disk • 

II, 12 

III, LVL I • 
III, LVLIII(4,4P)» 
III, Disk (4, 4P) • 
4, 4P, Disk • G^ 
CC, BASIC • 7=- 
CC, Ext BASIC • f$& 
CC, Disk • '-f* -~- 
MC-10 • —-re 

Model 100 • f " 

Model 100, Disk • - — ~ 

FORMAT 

//'ne#...PRINT iteml;item2;... 
lineff. ..LPRIl-U iteml;item2; 

EXAMPLES 

1000 PRINT h: 
1010 PRINT "NUMBER 
IS ";M 
DESCRIPTION 

In addition to acting as a delimiter in certain 
BASIC commands, the semicolon has a special use 
in PRINT statements. It is used in PRINT and 
LPRINT statements to mean "do not space'.' Both 
the video display and line printer lines are divided 
into "print zones',' which are similar to typewriter 
tabs. When a comma is encountered after a PRINT 
item, the BASIC interpreter will tab to the start of 
the next print zone. Using a semicolon, however, 
inhibits this tabbing and positions the video display 
cursor or the line printer print head over the next 
character position. This allows data items to be 
displayed or printed directly after related text or 
data items as in "PRINT "NUMBER IS 
' ' ;N," which would print 
NUMBER IS 123.56 

RELATED COMMANDS 



is 



N,"NEXT 




SYSTEM 

I, LVL I o 

I. LVL II » 

I, Disk e 

II, 12 e 

III, LVL I 
III, LVL III (4. 4P) • 

III, Disk (4, 4P) * 

4, 4P, Disk » 

CC, BASIC • 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 a 

Model 100, Disk « v 

FORMAT 

line#...expression<expression... 
EXAMPLES 

1000 IF (M-2}<N THEN GOTO 2000 
1010 IF ZZ<23 THEN ZZ=ZZ+5 ELSE 
ZZ— ZZ-1 

1020 IF LEFT$(A$,1)<"M" THEN 
PRINT "FIRST HALF" 

DESCRIPTION 

The < character is used either as a relational 
operator or as a string operator in BASIC. A 
relational operator compares two arithmetic 
quantities. When used as a relational operator, "<" 
stands for "less than" and is used to test one 
quantity against another, as in "IF fl<23". In this 
use, < is used in the IF. . . THEN or 
IF. . .THEN. . .ELSE commands. When used as 
a string operator, < is used to test two strings 
against each other. Strings are compared on a 
character by character basis, with each character 
representing a "weight" determined by its ASCII 
value. ASCII values roughly follow alphabetic 
sequence. An "A" is "less than" a "B" in this 
context. The < is again used in the IF. . .THEN 
and IF. . .THEN. . .ELSE commands for string 
comparisons as in "IF A$<' 'CALIF"" which 
tests string A$ for "less than" string "CALIF" 
RELATED COMMANDS <=<>,= >>= 




SYSTEM 

I, LVL I <» 

I, LVL II <• 

I, Disk ® 

II, 12 

III, LVL I <» 
III, LVL III (4. 4P) • 
III, Disk (4, 4P) ® 
4, 4P, Disk • 
CC, BASIC * 
CC, Ext BASIC 
CC, Disk <• 
MC-10 • 
Model 100 ® 
Model 100, Disk * 

FORMAT 

line#...expression<=expression... 
EXAMPLES 

1000 IF fM-2)<=N THEN GOTO 2000 

1010 IF ZZ<=23 THEN ZZ=ZZ+5 ELSE 

ZZ=ZZ-1 

1020 IF LEFTS (fl$,l)<="M" THEN 

PRINT "FIRST HALF" 

DESCRIPTION 

The <= characters are used either as a relational 
operator or as a string operator in BASIC. A 
relational operator compares two arithmetic 
quantities. When used as a relational operator "<=" 
stands for "less than or equal to" and is used to 
test one quantity against another, as in "IF 
A<=23'.' In this use, <= is used in the 
IF... THEN or IF. . .THEN. . .ELSE 
commands. When used as a string operator, <= is 
used to test two strings against each other. Strings 
are compared on a character by character basis, 
with each character representing a "weight" 
determined by its ASCII value. ASCII values roughly 
follow alphabetic sequence. An "A" is "less than" a 
"B" in this context. The <= is again used in the 
IF. . .THEN and IF. . .THEN. . .ELSE 
commands for string comparisons as in "IF 
A$<=" CALIF"" which tests string A$ for "less 
than or equal to" string "CALIF" 
RELATED COMMANDS <,<>, = ,>,>= 




SYSTEM 

LVLI <» 

LVL II o 

Disk • 

, 12 • 

I, LVL I ® 
I, LVL III (4, 4P)» 

I, Disk (4, 4P) <• 

4, 4P, Disk « 

CC, BASIC * 

CC, Ext BASIC • " 1 ' — 

CC, Disk • - . ' , ..' _ 

MC-10 ° .-.-•• 

Model 100 «• 

Model 100, Disk * 

FORMAT 

line#...expression<>expression... 
EXAMPLES 

1000 IF (M-2)ON THEN GOTO 2000 

1010 IF ZZ<>23 THEN ZZ=ZZ+5 ELSE 

ZZ=ZZ-1 

1020 IF LEFT$(A$,1)<>"M" THEN 

PRINT ' 'NOT M' ' 

DESCRIPTION 

The <> characters are used either as a relational 
operator or as a string operator in BASIC. A 
relational operator compares two arithmetic 
quantities. When used as a relational operator 
"<>" stands for "not equal to" and is used to test 
one quantity against another, as in "IF A<>23". 
In this use, <> is used in the IF. . .THEN or 
IF. . .THEN. . .ELSE commands. When used as 
a string operator, <> is used to test two strings 
against each other. Strings are compared on a 
character by character basis, with each character 
representing a "weight" determined by its ASCII 
value. ASCII values roughly follow alphabetic 
sequence. An "A" is "less than" a "B" in this 
context. The <> is again used in the 
IF. . .THEN and IF. . .THEN. . .ELSE 
commands for string comparisons as in "IF 
fl$<>' 'CALIF' ",' which tests string A$ for 
"not equal to" string "CALIF'.' 

RELATED COMMANDS <,<=, = ,>,>= 



SYSTEM 




I, LVL I • 

I, LVL II • 

I, Disk * 

II, 12 • 

III, LVLI 

III, LVL III (4, 4P)® 

III, Disk (4, 4P) • 

4, 4P, Disk • 

CC, BASIC • 

CC, Ext BASIC • 

CC, Disk • 

MC-10 « 

Model 100 <• 

Model 100, Disk •".... 

FORMAT 

//'ne# variable=expression 
//ne#. . . expression-expression.. . 
Iine#...string=string... 
EXAMPLES 

1000 PI =3. 14159 

101.0 IF N=(23-[1) THEN N=0 

1020 IF A$=B$ THEN PRINT 

"FOUND" 

DESCRIPTION 

The equals sign "=" is used to equate a variable to 
a quantity, as a relational operator, or as a string 
operator. When used as to equate a variable to a 
quantity, it separates the variable from a constant, a 
second variable, or an expression, and sets the 
variable on the left-hand side to the value of the 
argument on the right-hand side. When used as an 
arithmetic relational operator, it compares one 
expression with another, as in "IF ( X-2)-1024" 
It is used in this context with the IF. . .THEN and 
IF. . .THEN. . .ELSE commands. When used as 
a string operator, it compares two strings with one 
another, as in "IF A$=B$+C$" or "IF 
A$=' 'FALSE' ".' It is also used in the 
IF. . .THEN or IF. . .THEN. . .ELSE 
commands as a string operator. 
RELATED COMMANDS 
None 




SYSTEM 

, LVL I • 

, LVL II * 

, Disk • 

I, 12 • 

II, LVL I 

II, LVL III (4. 4P) • 
II, Disk (4 r 4P) o 

4, 4P, Disk * 

CC, BASIC • 

CC, Ext BASIC ° ',-- r ~ - .. o r r >f ,,— !>-. 

CC, Disk » _- ~. : .-. - ! ": '" c, 

MC-10 « _...:.. . ', .\._ 

Model 100 s f- — 

Model 100, Disk » l 

FORMAT 

line#...expression>expression... 
EXAMPLES 

1000 IF X>101 THEN GOTO 1050 
1010 IF ZZ>23 THEN ZZ=ZZ+5 ELSE 
ZZ=ZZ-1 

1020 IF LEFTS (fi$,l)>"Cfi" THEN 
STOP 

DESCRIPTION 

The > character is used either as a relational 
operator or as a string operator in BASIC. A 
relational operator compares two arithmetic 
quantities. When used as a relational operator ">" 
stands for "greater than" and is used to test one 
quantity against another, as m "IF fi>23". In this 
use, > is used in the IF. . .THEN or 
IF. . .THEN. . .ELSE commands. When used as 
a string operator, > is used to test two strings 
against each other. Strings are compared on a 
character by character basis, with each character 
representing a "weight" determined by its ASCII 
value. ASCII values roughly follow alphabetic 
sequence. A "Z" is "greater than" a "W" in this 
context. The > is again used in the IF. . .THEN 
and IF. . .THEN. . .ELSE commands for string 
comparisons as in "IF fl$>' 'CfiLIF'"', which 
tests string A$ for "greater than" string "CfiLIF". 
RELATED COMMANDS <,<=,<>,=,>= 














SYSTEM 

I, LVL I • 

I. LVL II • 

I, Disk ® 

II, 12 • 

III, LVL I • 
III, LVL III (4, 4P)* 
III, Disk (4, 4P) ® 
4, 4P, Disk • 
CC, BASIC * 
CC, Ext BASIC 
CC, Disk <• 
MC-10 • 
Model 100 » 
Model 100, Disk • 

FORMAT 

linett. ..expression>=expression.. . 

EXAMPLES 

1000 IF X>=101 THEN GOTO 1050 

1010 IF ZZ>=23 THEN ZZ=ZZ+5 ELSE 

ZZ=ZZ-1 

1020 IF LEFT$(fi$,11>="Cfi" THEN 

STOP 

DESCRSPTSON 

The >= characters are used either as a relational 
operator or as a string operator in BfiSIC. A 
relational operator compares two arithmetic 
quantities. When used as a relational operator 
">=" stands for "greater than or equal to" and is 
used to test one quantity against another, as in "IF 
fi>=23". In this use, >= is used in the 
IF...THENorIF...THEN...ELSE 
commands. When used as a string operator, >= is 
used to test two strings against each other. Strings 
are compared on a character by character basis, 
with each character representing a "weight" 
determined by its ASCII value. ASCII values roughly 
follow alphabetic sequence. A "Z" is "greater than" 
a "W" in this context. The >= is again used in the 
IF. . .THEN and IF. . .THEN. . .ELSE 
commands for string comparisons as in "IF 
fi$>=' 'CfiLIF"", which tests string A$ for 
"greater than or equal to" string "CALIF" 
RELATED COMMANDS <,<=,<>, = ,> 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P)- 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 



FORMAT 

lineti. . . A B 5(expression). . . 

EXAMPLES 

1000 REM FIND X DISTANCE 
1010 XD=ABS(X1-X2) 

DESCRIPTION 

ABS returns the absolute value of a constant, 
variable, or expression. It is a function that may be 
used anywhere within a BASIC statement. 
ABS(X)=X for X equal to or greater than 0. 
ABS(X)=-X for X less than 0. In other words, the 
result of the ABS is always positive. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III. LVL III (4, 4P)' 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

line#...(expression) AND (expression)... 

EXAMPLES 

1000 IF fA<2] AND ( Ei>5 .1 THEN PRINT 
"HELP!''' 

1010 IF |'A AND 3=31 THEN GOTO 8000 
DESCRIPTION 

AND is used as a relational operator and for bit 
manipulation. In the first use, AND compares two 
constants, variables, or expressions. If both 
expressions are true, then the AND function is true. 
In the example above, (A<2) AND (B>5) is true 
only if variable A is less than 2 AND variable B is 
greater than 5. The THEN action would only be 
taken if both expressions were true (expression 1 
AND expression 2). In the bit manipulation case, 
AND is used to logically AND integer variable bits, 
considered to be binary numbers. An AND of binary 
values produces a 1 for each bit position only if 
both operands have a 1 bit in that bit position. An 
AND of the two binary values 10100000 and 
11001111 would produce a result of 10000000. The 
AND in this application can be used to test bits, 
mask out fields, and perform other bit-wise 
operations. 

RELATED COMMANDS 
NOT, OR 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) • 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 



FORMAT 

linett...fiSC(string)... 

EXAMPLES 

1000 R=fiSC(A$ 

numeric 

1010 B=RSC( * *i 

"N" in numeric 

DESCRIPTION 

flSC finds the ASCII code of the first letter of the 
specified string. In other words it takes the string 
argument, strips off the first character, and returns 
it as a numeric value, rather than a string character. 
It is a partial "convert to numeric" as in VRL. In 
the second example above, RSC would take the 
string "NOW IS THE TIME',' strip off the "N" and 
return the "N" as a decimal 78, the ASCII code for 
"N" flbu can be used for alphabetizing and other 
string processing. RSC performs the inverse of the 
UHR$ function. 

RELATED COMMANDS 

CHR$, 5TR$, VRL 



) get first character of A$ in 

CIW IS THE TIME") get 



SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL 111 (4, 4P)« 

III, Disk (4, 4P) o 

4, 4P, Disk a 

CC, BASIC 

CC, Ext BASIC 

CC, Disk • 

MC-10 

Model 100 • 

Model 100, Disk » 




FORMAT 

linett. . . R T H(expression). . . 

EXAMPLES 

1000 PRINT RTN (XV 



?t: print angle 



DESCRIPTION 

RTN finds the arctangent of the argument. The 
arctangent is the angle in radians of the argument, 
assumed to be a tangent value. The expression may 
be a constant, variable, or expression. The result of 
RTN is in radians. To find the result in degrees, 
multiply by 180/pi, or 57.29578. RTN is the 
inverse of the TRN function, which finds the 
tangent of an angle in radians. 

RELATED COMMANDS 

TRN 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III. LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC 10 
Model 100 
Model 100, Disk 



FORMAT 

AUDIO ON 
lineti ROD 10 
AUDIO OFF 
lineU AUDIO 




IlFF 



EXAMPLES 

1000 AUDIO ON turn on TV speaker 
3000 AUDIO OFF turn off TV speaker 

DESCRIPTION 

AUDIO ON routes the cassette output to the TV 
speaker. The TV speaker can now be used to 
monitor CLOADs and CLOADMs of cassette files. 
This can be helpful in positioning the tape and 
verifying that cassette data is valid. AUDIO OFF 
turns off the audio routing, 

RELATED COMMANDS 

None 



SYSTEM 



LVL I 

LVL II 

Disk 
12 

, LVL I 

, LVL III (4, 4P)< 

, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

AUTO 

AUTO line ft 

AUTO linett, increment 

EXAMPLES 

AUTO 100 , 2 number lines 100 , 102 , 104,efc. 

DESCRIPTION 

AUTO invokes the automatic line numbering mode 
of BASIC. The BASIC interpreter will 
automatically display a line number, starting with 
the linefl start specified in the AUTO command, and 
will increment the line numbers by the increment 
number specified in AUTO. AUTO is used primarily 
in creating new programs; the user fills out the 
remainder of the BASIC line, terminates it with_ 
ENTER, and then continues with the next AUTO 
line number. The line# and increment are optional. 
If the increment is not specified, the default 
increment is 10. If neither the line number nor 
increment are specified, the starting line number is 
10. AUTO is not related to TRSDOS fiUTU. 

RELATED COMMANDS 

None 



SYSTEM 

i 
i 
i 
i 
I 
I 
I 



LVLI 

LVLII 

Disk 

, 12 

I. LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

BACKUP 

BACKUP source drive TO destination drive 

EXAMPLES 

BACKUP 
BACKUP TO 1 

DESCRIPTION 

BACKUP is a Color Computer Disk BASIC 
command that duplicates the contents of one 
diskette on a second diskette. The backup is an 
exact copy of the original disk. If a single drive 
system is used, the "BACKUP 0" form of the 
command is used; the Backup program will prompt 
you to switch diskettes at the proper times. If you 
have two or more disk drives, either the BACKUP Q 
or two-drive version of the command may be used. 
The backup is made from the diskette in the 
"source drive" to the diskette in the "destination 
drive" 

RELATED COMMANDS 

None 




SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 

FORMAT 

BEEP 
lineti BEEP 



EXAMPLES 

1000 BEEP output warning tone 

DESCRIPTION 

BEEP is used to output a tone for about one-half 
second. The tone can be used to signal the system 
operator or system user of an error condition or 
some action to be taken. You could use BEEP to 
indicate that the user has entered an invalid 
character during entry of numeric data, for example. 

RELATED COMMANDS 

SOUND 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 

CC, BASIC -_l;-; _., .v. J 

CC, Ext BASIC — r~-f-^- r^r'~" 

CC, Disk - ~ •--■ ' - rl .-.- = ;, 

MC-10 ." -"". _•-.-' "• ;>■ .••>. 

Model 100 « r "im '- - '' ' - - k" 

Model 100, Disk • v 

FORMAT 

//ne# CALL address, expressionl, expression2 

EXAMPLES 

1000 CALL 60000, VI, V2 call 
machine-language 

DESCRIPTION 

CALL is a function that allows a BASIC program 
to call any number of machine-language 
subroutines. One subroutine is called for each 
CALL command. The machine-language subroutine 
must have been previously loaded into memory. The 
subroutine location is defined by the address 
parameter in the subroutine call. The expressionl 
parameter is a constant, variable, or expression that 
can be resolved down to a value of through 255. 
It is put into the A register for subroutine use. The 
expression2 parameter is a constant, variable, or 
expression that can be resolved into a value of 
-32768 through 65535. It is put into the HL register 
for subroutine use. The machine-language 
subroutine will normally return back to the 
statement following the CALL. 

RELATED COMMANDS 

VARPTR 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//7?e# UALL address 

linett CALL address(parameter list) 

EXAMPLES 

1000 CALL &HD000 
call machine-language 
2000 CALL &HD000I 
pass one parameter 
3000 CALL &HD000I, 
pass three parameters 

DESCRIPTION 

CALL is a function that allows a BASIC program 
to call any number of machine-language 
subroutines. One subroutine is called for each 
CALL command. The machine-language subroutine 
must have been previously loaded into memory. The 
subroutine location is defined by the address 
parameter in the subroutine call. The parameter list 
is optional and may be from one to three 
parameters. The parameters are put into the HL, DE, 
and BC registers. The values put into the three 
registers are pointers to the parameters and not the 
actual values of the parameters themselves. A return 
is normally automatically made by the subroutine to 
the statement following the CALL. 
RELATED COMMANDS 
USER, VARPTR 



HI 



' a , b , c 




SYSTEM 

I, LVL I 

I, LVL II o 

I, Disk ® 

II, 12 ® 

III, LVL I 

III, LVL III (4, 4P) ® 
III, Disk (4, 4P) • 
4, 4P, Disk ® 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 • I — 

Model 100, Disk ® 

FORMAT 

linett. . . c D B L(expression). . 



EXAMPLES 

1000 PRINT CDBL(ia/JX) print double 

DESCRIPTION 

CDBL forces processing in double precision, even 
though some of the variables involved may be 
integer or single-precision operands. CDBL is used 
whenever the result is required to be of double- 
precision accuracy (17 decimal digits of 
significance, 14 on the Model 100). Of course, if the 
processing done up to a particular point has been 
extensive, and only in single precision, CDBL 
cannot retrieve the lost digits of significance! In the 
example above CDBL (l%/J%) is accurate because 
both 1% and J% are integer variables and have lost 
no significance in processing. Performing a 
CDBL(A/B) will in many cases be accurate only to 
single-precision accuracy as A and B are single- 
precision variables. 

RELATED COMMANDS 

CINT, CSNG , 




"filename" 
"filename",linett 
"filename", linett, hLL 
"filename",linett,f\LL , DELETE 



f'lERUE "filename", 



SYSTEM 

I. LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III. Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

linett CHfilt 
linett LHfilt 
linett CHflll 
linett CHAII 
linett-linett 
linett CHAII 

EXAMPLES 

1000 CHAIN "NEXTPR 
NEXTPR at line 100 
2000 CHAIN MERGE 

NEXTPR and merge 
DESCRIPTION 

CHAIN is used to load a second BAblt: program 
from disk and to execute it from the original program. 
The second program may contain other CHAIN 
commands to execute other programs and so on. The 
basic CHAIN simply loads a new program and 
executes from the beginning. Use COMMON to retain 
variables. The CHAIN with line number executes the 
new program from the given line number. The CHAIN 
with ALL option retains variables in the original 
program as the new program is executed. The 
DELETE option deletes a given range of lines in the 
original program so that the new program is merged. 
The CHAIN MERGE command overlays original lines 
with new lines similar to MERGE command action. 
RELATED COMMANDS 

COMMON, MERGE 



100 execute 



NEXPTR 



execute 



SYSTEM 

, LVLI 
, LVL II 

, Disk • 

I, 12 • 

II, LVL I 

II, LVL III (4. 4P) • 

II, Disk (4, 4P) • 

4, 4P, Disk ® 

CC, BASIC • 

CC, Ext BASIC ® 

CC, Disk « 

MC-10 • 

Model 100 • 

Model 100, Disk • 




FORMAT 

line#...CHR$(expression)... 



EXAMPLES 

1000 PRINT 
SEQUENCE" 



"ESCfiPE 
;CHR$|'27'i 



;CHR$(101' 



DESCRIPTION 

The CHR$ function converts one numeric value to a 
one-character string. The one-character string can 
then be appended to other strings or used as a 
single-character string. CHR$ allows a way of 
specifying non-ASCII characters from the keyboard. 
Certain line printers expect to see numeric codes 
which have no keyboard equivalent; CHR$ permits 
embedding these codes in a string sent to the line 
printer. CHR$ can also be used to construct strings 
used for graphics purposes. CHR$ performs the 
inverse of the FiSC function. 

RELATED COMMANDS 

RSC, STR$, VfiL 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I. 12 

II, LVL I 

II, LVL III (4, 4P) ■ 
II, Disk (4, 4P) > 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk < 




:INT(U8j convert and 



FORMAT 

linett.X I HJ(expression).. 

EXAMPLES 

1000 R=CINT(Btt 
multiply 

DESCRIPTION 

CI NT forces processing to be done in integer 
mode. The constant, variable, or expression is 
converted to an integer by the CI NT function. 
Integer values are held in two bytes and may range 
from -32768 to +32767. The CI NT converts the 
argument to an integer variable by using only the 
integer portion of the argument. If the argument 
were 3456.777, for example, the result of CINT 
would be 3456. CINT is used anytime that a 
variable or expression can be converted to integer 
to speed up processing. 

RELATED COMMANDS 

CDBL, CSNG 




SYSTEM 

I, LVL I 

I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4 r 4P) 
4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC * -_.r , __-; 

CC, Disk * V: . . 

MC-10 

Model 100 - . . . " ;•••'■ -.- 

Model 100, Disk '" 

FORMAT 

//'ne# CIRCLZ(x,y),r circle 
//'ne# CIRCLE(x,y),r,c circle with color 
//ne# CIRCLE(x,y),r,c,hw ellipse 
linett ClRCLE(x,y),r,c,hw,start,end arc 

EXAMPLES 

1000 CIRCLE ( 129 , 96 ) , 40 radius 40 circle 
1010 CIRCLE(200, 100) ,20,4,1,0, -25 
red arc 

DESCRIPTION 

CIRCLE is used to draw a circle, ellipse, or arc at 
any point on the current graphics screen. The x and 
y parameters specify the center point for the circle, 
ellipse, or arc. The ranges of x and y are through 
255 and through 191, respectively. The r 
parameter is the radius of the circle or 1/2 the 
width of the ellipse. The c parameter is the color 
code (1 through 8) for the figure. The hw parameter 
is the height/width ratio for the figure. A circle has 
hw=l, ellipses hw ratios from through large 
values. The "start" and "end" parameters define the 
start and end points of the arc. Any value from 
(three o'clock) through 1 (clockwise back to three 
o'clock) may be used to define the start and end 
points. Commas may be used in place of the c, hw, 
start, and end parameters. Defaults are 
c=foreground, hw=l, start=0, and end=l. 
RELATED COMMANDS 
None f 




SYSTEM 

I, LVL I 

I, LVL II * 

I, Disk ® 

II, 12 

III, LVL I 

III. LVL III (4. 4P) • 

III. Disk (4. 4P) o 
4, 4P, Disk 

CC, BASIC • 
CC, Ext BASIC 

CC, Disk <• 

MC-10 • 

Model 100 » 

Model 100, Disk «» 

FORMAT 

CLEAR N (Model 1,11,111, MC-10, Model 100) 
CLEAR N,M (Color Computer, Model 100) 
lineff CLEAR N or CLEAR N,M 
EXAMPLES 

1000 CLEAR 1000 clear 1000 bytes for strings 
1010 CLEAR 100,16000 clear 100 bytes for 
strings, protect memory 
DESCRIPTION 

CLEAR clears all variables to and sets aside a 
specified number of bytes of RAM for a "string 
storage area'.' This string storage area is used 
exclusively as a working storage area for string 
processing. Enough bytes should be set aside to 
handle the maximum number of characters in string 
variables during program execution. This is usually a 
trial and error computation. If too few characters 
are set aside, either an "out of string space" error 
will occur, or some time will be lost while the 
BASIC interpreter "cleans up" the string storage 
area to make room for new strings. In the Color 
Computer and Model 100, a second parameter 
protects all RAM from a given address up to "top of 
RAM"; this area is normally used for storage of 
machine-language programs or buffers. Top of RAM 
in the Model 100 is called MAXRAM. 
RELATED COMMANDS 

ERE, MAXRAM (100], HIMEM(100) 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

CLERR N 
CLERR N,M 
CLERR N,M,P 
EXAMPLES 

CLEAR 1000 clear 100 bytes for strings 
CLERR 100,16000,200 clear 100 bytes for 
strings, protect memory, use 200 bytes for stack 

DESCRIPTION 

CLERR clears all variables to and sets aside a 
specified number of bytes of RAM for a "string 
storage area". This string storage area is used 
exclusively as a working storage area for string 
processing. Enough bytes should be set aside to 
handle the maximum number of characters in string 
variables during program execution. If too few 
characters are set aside, either an "out of string 
space" error will occur, or some time will be lost 
while the BASIC interpreter "cleans up" the string 
storage area to make room for new strings. A second 
parameter protects all RAM from a given address to 
"top of RAM"; this area is normally used for storage 
of machine-language programs or buffers. A third 
parameter sets aside space for the stack. 
RELATED COMMANDS 
FRE 




SYSTEM 

LVL I « 

LVL II © 

Disk «» 
. 12 
I, LVL I 

I. LVL III (4, 4P) ® 

I, Disk (4, 4P) ® 
4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC •» 

CC, Disk ® 

MC-10 ® 

Model 100 ® 

Model 100, Disk * 

FORMAT 

CLOfiD "file name" 
CLORD 

EXAMPLES 

CLORD "RRTTRIL" 

DESCRIPTION 

CLORD is used to load a BASIC program file from 
cassette. The file name, if used, must be in quotes. 
If no file name is specified in the CLORD 
command, the next BRSIC file from cassette will 
be loaded. If a file name is specified, the cassette 
tape will be searched for that specific file name. File 
names are one character long in the Model I and III 
and up to six characters long in the Color Computer. 
As BASIC searches for the proper file, it will 
display all files encountered on the video display. 
When the next or named file is found, it is assumed 
to be a BASIC file, and will replace any current 
BASIC program in RAM. In addition to initializing 
the BASIC program area, a CLOAD also resets all 
variables to and initializes other BASIC program 
parameters. For systems with two cassettes, see 
CL0AD8-. Model 100: CLOAD "file name", 
R loads and runs a program. 

RELATED COMMANDS 

CLOADtt-, CLOAD?, CSAVE 




SYSTEM 

LVLI 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

CLOADtt -l,'Y/7e name" 
CLOADtt-- 2, "f/'/e name" 

EXAMPLES 

CLOADtt -1,"RATTAIL" 

DESCRIPTION 

CLOADtt- is used to load a BASIC program file 
from cassette when two cassettes are used in the 
system. The file name, if used, must be in quotes. If 
no file name is specified in the CLOADtt - 
command, the next BASIC file from cassette will 
be loaded. If a file name is specified, the cassette 
tape will be searched for that specific file name. File 
names are one character long in the Model I. When 
the next or named file is found, it is assumed to be 
a BASIC file, and will replace any current BASIC 
program in RAM. In addition to initializing the 
BASIC program area, a CLOADtt- also resets all 
variables to and initializes other BASIC program 
parameters. 

RELATED COMMANDS 

CLOAD78-, CSAVEttl- 



SYSTEM 




, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 
CC, BASIC 

cc, Ext basic ,. r; r .r-T\.-~°-M « , ^'"°\ ~ - 

CC, Disk '_V- - -:." ">- - r £'- ' T .~ ' - -' '-- ---h; ; 

MC-10 • .'- -—; ,-f :: '- t* > - - c . ' . «;>_' 

Model 100 ^^ -■ "--^- :1 

Model 100, Disk l 

FORMAT 

CLOAD* array 

CLOAD* array name, "file name" 

EXAMPLES 

CLOAD* A, ' 'PROG1' ' 

DESCRIPTION 

CLOAD* is used to load a BASIC program and 
numeric array data from cassette tape. It operates 
identically to CLOAD except that in addition to 
loading a previously saved BASIC program, 
CLOAD* also loads a previously saved numeric 
array. The file name is optional. If a file name is not 
used, the next BASIC file will be loaded. If a file 
name is specified, the cassette tape will be searched 
for the specified file name. The BASIC program 
and array data must have been saved on cassette 
by a CSAVE* command. The array used in the 
load must be defined by a DIM statement or by 
implicit use of an array element. The array used 
may be larger than cassette data but not smaller. 

RELATED COMMANDS 

CLOAD, CSAVE*, DIM 




SYSTEM 

LVL I 

LVL II • 

Disk • 

, 12 
I, LVL I 

I, LVL III (4. 4P)« 
I, Disk (4, 4P) « 
4, 4P, Disk 
CC, BASIC 

cc, Ext basic •-.-. • . . j; ; •. - •■ 

CC, Disk . - ' - '--'--• 

MC-10 

Model 100 • 

Model 100, Disk • 

FORMAT 

CLOAD? "file name" 
CLOflD 

EXAMPLES 

CLORD? "RATTAIL" 

DESCRIPTION 

CLORD? is used to compare a program on cassette 
with the BASIC program in RAM. It is normally 
used directly after a CSRVE operation to compare 
the BASIC file just saved with the contents of 
RAM. This ensures that the BASIC program will not 
be destroyed before a valid copy has been saved on 
cassette. The "file-name" is optional. If no file name 
is specified, then the next file on cassette will be 
compared with the BASIC program in RAM. If a 
file name is specified, the BASIC interpreter will 
search cassette until the specified file is found. If 
the file on tape is not identical with the contents of 
RAM, a "BAD" message will be displayed and 
another C5AVE operation must be done. The 
BASIC program in RAM is not altered during the 
comparison process. If the system used has two 
cassettes, see CLOAD ?8. 

RELATED COMMANDS 

CLOAD, CL0AD78-, CSAVE 




SYSTEM 

LVL I 
LVL II 

Disk • 

, 12 
I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC ~ I. .. . T -. 

CC, Disk .'". • \" V , : " •- 

MC-10 —---■,- -V.v- ■-"."- .• . -•--.■.:* 

Model 100 
Model 100, Disk i 

FORMAT 

CLOAD ?8-l,7/7e name" 

CLO AD ?8 - 2, "file name" 

EXAMPLES 

CLOAD78-2,' 'RATTAIL" 

DESCRIPTION 

CLOAD ?8- is used to compare a program on 
cassette with the BASIC program in RAM for those 
systems that have more than one cassette. It is 
normally used directly after a CSAVE8- operation 
to compare the BASIC file just saved with the 
contents of RAM. This ensures that the BASIC 
program will not be destroyed before a valid copy 
has been saved on cassette. The "file-name" is 
optional. If no file name is specified, then the next 
file on cassette will be compared with the BASIC 
program in RAM. If a file name is specified, the 
BASIC interpreter will search cassette until the 
specified file is found. If the file on tape is not 
identical with the contents of RAM, a "BAD" 
message will be displayed and another CSAVE8- 
operation must be done. The BASIC program in 
RAM is not altered during the comparison process. 
The 8-1 command will compare from cassette 1 
and the CL0AD?8-2 command will compare from 
cassette 2. 

RELATED COMMANDS CL0AD8-, CSAVE8- 




SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC • 

CC, Ext BASIC • 

CC, Disk • ... - - -., ,---\v 

MC-10 • • - -.- -'-- "- ; > U 5 

Model 100 • --- - 

Model 100, Disk • 

FORMAT 

CLOfiDM 

CLOADM"f/7ena/ne" 

CLOfiDM "filename" offset (Color Computer) 

EXAMPLES 

CLOFIDM 4 * GRRPHC ' load file "GRRPHC" 

into RAM 

DESCRIPTION 

CLOfiDM is used to load a machine-language file 
from cassette tape. The cassette tape file may have 
been generated by an Editor/ Assembler or be in a 
format compatible with the CLOfiDM function. When 
CLOfiDM is used alone, the next file on cassette is 
assumed to be a machine-language file and is 
loaded into RAM. When the "CLOfiDM"filename" " 
format is used, the CLOfiDM routine will search for 
the specified file name on cassette. When it finds 
the file, it will be loaded into RAM as a machine- 
language file. 

Color Computer: When the "CLOfiDM"filename" 
offset" format is used, the named machine- 
language file will be loaded into RAM at the normal 
locations specified in the file plus the offset value. 
The offset value may be any value except those that 
cause the load address to be in "non-existent" 
RELATED COMMANDS 
EXEC i 




SYSTEM 

I, LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVLI 

III. LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC. BASIC 
CC. Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

linett CLOSE buf#l,buW2 l ...,buf#n 
EXAMPLES 

1000 CLOSE 1,3 close files for buffers 

1 and 3 

DESCRIPTION 

CLOSE "closes" a disk file or files. A disk file is 
normally first OPENed for reading or writing. The 
OPEN command causes BASIC to find the file 
name in the directory and to establish the disk 
location of the file, type of file, and other 
parameters. OPEN also allocates a RAM "buffer" to 
be used with the file. The RAM buffer is the memory 
area used for reading or writing disk sectors. Buffers 
are allocated by number, and the OPEN associates 
a specified file name with the buffer number. After 
the records of the file have been read or written, a 
CLOSE "flushes" any remaining data in a buffer for 
a write and properly terminates file operations for 
the designated buffer or buffers. The "buf#" 
parameters specify the buffer numbers, and hence, 
the files to be closed. One or more buffer numbers 
may be specified. 

RELATED COMMANDS 

OPEN 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 ® 
Model 100, Disk * _.. .-_ . . .- 

FORMAT 

CLOSE 

CLOSE file number list 

linefi CLOSE 

linett CLOSE file number list 

EXAMPLES 

close close all open files 

1000 CLOSE close all open files 

2000 CLOSE 3,4 close file numbers 3,4 

DESCRIPTION 

CLOSE "closes" a RAM, CAS, COM, LCD, LPT, 

or disk file. The file is normally first uPENed for 

reading or writing. The OPEN command establishes 

the file name and other parameters. OPEN also may 

allocate a file buffer for the file. The file buffer is 

assigned a number for use with the file. After the 

records of the file have been read or written, a 

CLOSE "flushes" any remaining data in the buffer 

for a write and properly terminates file operations 

for the designated buffer or file number. If a 

CLOSE is used without a file number all currently 

OPENed files are closed. 

RELATED COMMANDS 

OPEN 



SYSTEM 



, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk ■ 



FORMAT 

linett CLS 

linett CLS c Color Computer 

EXAMPLES 

1000 CLS clears video display 




2000 CLS 
Computer) 



clears display to blue (Color 



DESCRIPTION 

Model l/ll/lll, 12, 4, Model 100: CLS clears the 
entire video display screen by outputting blanks to 
each of the screen character positions. Note that 
this is an ASCII 32, an alphabetic blank, rather than 
a graphics character. The screen cursor is then 
positioned in the upper left-hand corner of the 
screen. 

Color Computer, MC-10: CLS clears the entire 
screen to a specified color, c. The c parameter is a 
color code of through 8 (black, green, yellow, 
blue, red, buff, cyan, magenta, orange). 

RELATED COMMANDS 

None 




SYSTEM 

LVLI 

LVLII 

Disk 

, 12 

I. LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

CMD " R " 

EXAMPLES 

CMD "ft" 

DESCRIPTION 

The CMD' 'A' ' command allows you to return to 
TRSDOS from BASIC. Typing in "CMD' 'A'"' at 
any time when in the command mode of BASIC 
causes a return to TRSDOS. 

>CMD"A" 
OPERATION ABORTED 
TRSDOS READY 

RELATED COMMANDS 

None 



SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC40 

Model 100 

Model 100, Disk 




FORMAT 

CMD " B ". 
CMD " B ". 



"DM" 
"OFF' 



EXAMPLES 

CMD " B ", " ON " enables the BREAK key 

operation 

CMD " B ", " OFF " disables the BREAK key 

operation 

DESCRIPTION 

CMD' 'B" is used to enable or disable the BREAK 
key. The BREAK key is normally used to stop 
execution of a BASIC program. When the BREAK 
key is disabled with a CMD' 'B", "OFF", the 
BREAK key will be ignored except during cassette, 
printer, or serial input/output. CMD' 'B" can be 
used to "lock out" the BREAK key to prevent 
erroneous stops of critical BASIC programs. The 
double quotes around ON and OFF are necessary. 
The BREAK key will be enabled upon a return to 
TRSDOS. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL 111(4, 4P) 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 



CMD' 'C 
CMD"i: 

i::rci"i: 




%R 



compress program by deleting 



EXAMPLES 

CMD"C",S 
spaces 

DESCRIPTION 

UMD' 'u' ' is a command to "compress" a 
program by deleting remarks and/or spaces. 
BASIC program remarks take up about one byte in 
RAM for every REM character. They are most useful 
during program debugging and may be deleted after 
a final version of the program has been reached. 
Spaces help readability, but also take up one byte 
of RAM for every space. If the CMD' 'C ' format 
is used, text from both REMs (and ' type remarks) 
and spaces are deleted from the BASIC. If the 
other formats are used either remarks or spaces are 
deleted. All spaces except those inside string literals 
will be deleted. String literals (such as A$="STRING 
LITERAL") must have double quotes at both 
beginning and end for the command to function 
properly. 

RELATED COMMANDS 

None I 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



CMD hi D" 
I I I 



FORMAT 

Cf1D"D" 

EXAMPLES 

CMD " D " load DEBUG from disk 

DESCRIPTION 

CMD' 'D" loads the DEBUG program from disk. 
DEBUG may be entered by pressing the BREAK key 
at any time after DEBUG has been loaded. DEBUG 
is used to examine memory, execute machine- 
language programs, and perform other non-BRSIC 
tasks. BASIC program text and variables will be 
lost after transfer of control to DEBUG . 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) - 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



1 ' * c 

III" 



FORMAT 

r:riD"D:d" 

EXAMPLES 

CMD"D:1" 



display directory of drive 1 



DESCRIPTION 

CMD' 'D" is a BASIC command similar to the 
TRSDOS DIP. command. It allows the user to 
display a diskette directory from inside BASIC 
without transferring to TRSDOS. The "d" parameter 
is the drive number, through 3. Only unprotected, 
visible files will be displayed. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 






7".f"1 
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m>j 




f*sil 
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Cj 


|gp| 




list 










#o3 


&sW*~ 


By 


Qfjajd 




tr_™jr* 


3* 1 




BE 





FORMAT 

Cf1D"E" 

EXAMPLES 

Cr1D"E" 



display last TRSDOS error 



DESCRIPTION 

CMD"E' ' displays the last TRSDOS error from 
within BASIC. It is a way of getting further 
information about the type of TRSDOS error that 
occurred, rather than a "blanket" statement. If, for 
example, BASIC returned a 
"DISK I/O ERROR", entering CMD"E' ' would 
expand on this by displaying the last TRSDOS error 
message of "DISK DRIVE NOT IN SYSTEM". 
This message would not have been displayed during 
BASIC program execution. 

RELATED COMMANDS 

None 



SYSTEM 

LVLI 

LVLII 

Disk 

12 

, LVLI 

, LVL III (4, 4P) 

, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

CMD " I ", "command" 
lineti CMD' ' I ' ' /'command" 



EXAMPLES 

1000 fi$="DIR' ' 
1010 CMD"I",fi$ 
and do dir 




exit to TRSDOS 



DESCRIPTION 

CMD " I " returns control to TRSDOS from 
BASIC and passes a command. The command is 
executed as the first TRSDOS action. 

RELATED COMMANDS 

None 



:md fc 



SYSTEM 

LVLI 

LVLII 

Disk 
, 12 
I, LVL I 

I, LVL III (4, 4P) 

I, Disk (4, 4P) • __„___„ 

4, 4P, Disk . " . . 

cc, basic ,-=• n;_ i^-'-z "~"-^« 

CC, Ext BASIC , ' •'-, - v i ,;?:M', i, ( 1 ;\;.;-\ 

CC, Disk -' _:-''-- -*-;'•- /r^-i^A 

mc-io --'-"- - :S ■ -\ '.-"■- \> 'i; ' : - 5 U \ 

Model 100 i -~— " , 

Model 100, Disk 

FORMAT 

lineti CMD " J " , "mm/dd/yy" string 

//ne# CMD " J ' ' , "-yy/ddd", string 

EXAMPLES 

1000 CMD " J ", 12/05/81 , fi$ convert date 

DESCRIPTION 

CMD " J " converts a given date to "day-of-the- 

year" format or converts the day of the year to 

mm/dd/yy format. The "dd" or "ddd" parameter is 

the day. The "mm" and "yy" parameters are month 

and year, respectively. This command is used to 

convert the mm/dd/yy format to ddd format or the 

yy/ddd format to mm/dd/yy format. The result of 

CMD' ' J' ' is the format opposite to the one 

specified after the CMD' 'J". The result is held in 

the specified string. CMD' 'J" is handy for 

converting to and from "Julian" format (yy,mmm) 

where the day of the year is 1 through 366. Julian 

format facilitates processing of elapsed time. The 

minus sign prior to the yy/ddd is required. The 

command CMD" J' % ' '12/05/81' ',A$ 

produces A$="339". The command 

CMD " J ", " -81/300 ' ' ,A$ produces 

A$="10/27/81". 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) < 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

CMD' 'L* * "filename" 
CMD' 'L' \string 

EXAMPLES 

1000 CMD " L ", " R33EMP : 1 " load 
machine language 

DESCRIPTION 

CMD' 4 L" loads in a machine-language file 
created by the TRSDOS DUMP command or Disk 
Editor/Assembler. The machine-language file would 
normally contain code to be interfaced to BRSIC 
through the DEFUSRn and USRn commands. The 
machine-language code cannot overlay the RAM 
area protected by the MEMORY SIZE? prompt. If 
the filename format is used, the filename must be 
enclosed by quotes; if the string format is used, 
quotes are not required. CMD' 'L",R$ will load 
in the file named in A$, assumed to be a machine- 
language file. 

RELATED COMMANDS 

DEFUSRn, USRn 



SYSTEM 




I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) • 
4, 4P, Disk 

CC, BASIC -v Z.~l .' "~: - 

CC, Ext BASIC ,i ,: >VV.O "; > 

CC, Disk 

MC-10 " ----- - ','- V 

Model 100 
Model 100, Disk 

FORMAT 

linett CMD' 'U' ' , integer vahable,string array(start) 

EXAMPLES 

1000 Z&=100 

1010 CMD " * \ Z% , fi$ f 20 ] sort array 
DESCRIPTION 

CMD' '0' ' sorts a one-dimensional string array 
from a specified starting element number through a 
specified length. The sort will sequence the array 
entries so that they are ordered in "ascending 
sequence" based upon their ASCII codes and other 
values. Normal string array entries will contain ASCII 
representation of string variables. If the entries of 
the string array contain non-ASCII characters, such 
as control codes or graphics characters, the sort will 
be on the basis of their numerical values from 
through 256. The "string array(start)" parameter 
defines the starting element of the string array. This 
may be the first element (0) or any element of the 
array. The integer variable parameter defines the 
number of elements from this start element. The 
sort will be performed on the array elements from 
the start through the start+n-1. The array element 
strings may be of mixed lengths. 
RELATED COMMANDS 
None 



CMD' S P'. 



SYSTEM 

, LVL I s— -— aa^-as-^ 

, LVLII ■- ^ t^^±-—.-=^^= =s>< 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II. Disk (4, 4P) • 

4, 4P, Disk ~ """■ " " .- 

CC, BASIC f^ZsZ^^y^ Z-^ZZ^, 

CC, Ext BASIC /vC^;Z--^t-t4l!! vjr.'^p'^ 

CC, Disk ^.ft-^^^i-frc^nt'.^rrA^ri 

MC-10 i'~ ~-=--^j ~ "" sBV/^i 

Model 100 

Model 100, Disk "~- ^- ~ ~ -'- - --~-—^~~- - 7 - 

FORMAT 

lineti CMD' 'P' * .string 
EXAMPLES 

1000 CMD " P ", A$ get printer status 

DESCRIPTION 

CMD' 'P" reads in the system printer status. The 
printer status is returned as a string variable, the 
string parameter. This command is used to test the 
ready condition of the system line printer before 
using an LPRINT or other command. The line 
printer may not be ready because it is "off-line" or 
because of an error condition such as being out of 
paper. Printer status can be tested by converting 
the string result to numeric by the VfiL command, 
and flNDing with 240 to obtain the most significant 
4 bits of the status. Generally, if the result of the 
VAL conversion and flNDing is not 48 (binary 
0011XXXX), the printer is not ready, although this 
depends upon the printer type in your system. 
Sample code is 
1000 CMD"P",A$ 
1010 fi=VAU'A$) AND 240 
1020 IF A<>48 THEN PRINT "PRINTER 
NOT READY ' ' 

RELATED COMMANDS 

None I 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

i::MD"R" 

EXAMPLES 

CMD "R" turns on the real-time clock 

DESCRIPTION 

CMD' 'R" is used to turn on the real-time clock 
from BASIC. The system real-time clock displays 
the 24-hour time at the upper right-hand corner of 
the screen. The time can be set by the TRSDOS 
TIME command. When the real-time clock is on, 
the time will be updated in fractions of a second 
and displayed in seconds. The real-time clock is 
always running except during cassette or disk 
input/output; CMD' 'R" simply enables the time 
display during all BASIC activity. The display can 
be disabled by the CMD' 'T" command. 

RELATED COMMANDS 

CMD"T", TIME (TRSDOS) 



SYSTEM 

LVLI 

LVLII 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 






:MD A 4, o 









FORMAT 

CMD "S" 

EXAMPLES 

CMD"S" 



return to TRSDOS 



DESCRIPTION 

CMD"S' ' is used to return to TRSDOS from Disk 
BASIC. Executing CMD"S" will exit Disk 
BASIC and reload TRSDOS. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III. LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

CMD " T " 

EXAMPLES 

CMD * ' t ' ' disables the real-time clock display 

DESCRIPTION 

CMD' 'T" turns off the system real-time clock 
from the command mode of BASIC. The real-time 
clock updates the time in fractions of a second and 
displays the 24-hour time in seconds in the upper 
right-hand corner of the screen. It is always 
running, except during cassette or disk 
input/output; using CMD' 'T" simply disables the 
screen display. 

RELATED COMMANDS 

CMD"R", TIME (TRSDOS J 



SYSTEM 



LVLI 

LVLII 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) - 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

//ne# CMD' 'X' \reserved wd 
//ne# CMD' 'X' ' ,' 'string" 

EXAMPLES 

1000 CMD "X' ', PR I NT find all PR I NTs 

DESCRIPTION 

CMD' 'X' ' will search the current BASIC 
program in RAM for either a reserved word such as 
PRINT or GOTO, or for a given string literal such 
as "EMPLOYEE #" The line numbers of all 
occurrences of the reserved word or string literal 
will then be listed on the display. CMD' 'X' ' can 
be used as a general search routine to facilitate 
changes in a BASIC program. A search for 
PRINT, for example, could easily be done and the 
PRINTS could then be changed to LPRlNTs. The 
reserved word must not be in quotes; a string literal 
must be enclosed in quotes. 

RELATED COMMANDS 

None 



SYSTEM 

LVLI 

LVLII 

Disk 

, 12 

I. LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




turn on printer output 



FORMAT 

CMD"Z", "ON" 
CMD"Z", "OFF' 

EXAMPLES 

CMD"Z", "ON" 

DESCRIPTION 

CMD' 'Z" is used to enable or disable 
simultaneous display and printer output. When 
CMD " Z ", " ON " is given, all output going to 
the display is also sent to the system line printer. 
The printer must be in a "ready" condition. Due to 
differences in character interpretation, display 
output sent to the line printer may cause 
unpredictable results, but in general, any text data 
sent to the screen will be properly printed on the 
system line printer. The printer output is disabled 
by CMD' 'Z", ' 'OFF' '. This command can be 
used to provide a hard copy of BASIC program 
output which normally would be displayed. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4 t 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

//'ne# COLOR foreground,background 

EXAMPLES 

1000 COLOR 2 , 3 select yellow on blue 

DESCRIPTION 

COLOR is used to select the foreground and 
background colors in either the text or graphics 
modes. The background is the field upon which 
figures can be drawn; the foreground is the color 
used to draw the figures. The color codes used are 
the standard Color Computer codes of through 8 - 
black, green, yellow, blue, red, buff, cyan, magenta, 
and orange, respectively. The color codes used in 
the command must be valid colors in the current 
mode. The current mode depends upon the current 
SCREEN command in force (text or graphics) and 
the graphics mode (PMODE). The background may 
be selected to be the same color as the "border" 
color, in which case there will be no border around 
the screen. 

RELATED COMMANDS 

PMODE, SCREEN j 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 

CC. BASIC ,f-~ x ' _- -•-" ^-— - • -=- ~ 

CC, Ext BASIC :,G S --.,"~-T:>3>l . I >- r i , V. 

CC, Disk --.._ 

MC-10 - ~- -,~±K -Jr." - : ' ; -" i "«; , V • 

Model 100 • f = ^=-" - - • ^| 

Model 100, Disk • l -- -™ :_ .-•--"_. — _ ™rr^ - 

FORMAT 

//ne# COM ON 
//'ne# COM OFF 
//'ne# COM STOP 

EXAMPLES 

1000 COM ON enable communications interrupt 

DESCRIPTION 

The communications interrupt is used to interrupt a 
BftSIC program so that immediate action is taken 
to save a character received from the RS-232-C port 
of the system. If this action were not taken 
immediately, the character would be lost. The ON 
COM GOSUB command is first used to define a 
"processing" subroutine for the interrupt. Normally 
this subroutine would read in the character from the 
COM file and process or save it and then return to 
the interrupted program. The COM command allows 
the communications interrupt to be enabled or 
disabled by a COM ON or COM OFF — there are 
times when the interrupt should be acted upon and 
other times when it should be ignored. The COM 
STOP "remembers" the interrupt but allows the 
program to ignore it until the next COM ON, at 
which point the interrupt subroutine is immediately 
called. 

RELATED COMMANDS 
ON COM, OPEN 




SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4 T 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 



FORMAT 

lineti COMMON variable list 
EXAMPLES 

1000 COMMON RZ , BZ , PT f ) make common 
DESCRIPTION 

COMMON is used to establish a common area for 
variables so that several BRSIC programs can use 
the same variables. The BRSIC programs are 
loaded at different times by the CHRIN program. 
As the programs are loaded they may "overlay" 
prior programs, but variables defined as COMMON 
variables will be maintained with their names and 
current values. In this way, variables may be 
"passed" from program to program as they are 
CHAINed. The variable list of COMMON may have 
one or more variable names. No variable name may 
appear in more than one COMMON statement. The 
variable names may reference any variable types. If 
an array is to be common to two or more programs, 
use parentheses to indicate the array, as shown in 
the example above. 
RELATED COMMANDS 
CHRIN 




SYSTEM 

, LVL I 
, LVL II 
, Disk 

I. 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 

FORMAT 

CONT 



EXAMPLES 

CONT (continue after stop) 

DESCRIPTION 

CONT is an abbreviation for "continue" Continue is 
used after a STOP command has been executed. 
The STOP causes a temporary program halt, 
valuable for examination of variables or 
"breakpointing" during debugging. CONT is used 
after the STOP to continue the program from the 
point at which the STOP occurred. All variables will 
be intact when the CONT is executed. CONT is 
used in the command mode after a STOP or 
BREAK has taken place. 

RELATED COMMANDS 



i'TOP 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

Ml, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

COPY "filenamel" TO "filename2" 

EXAMPLES 

COPY "TRF1NSFIL/BRS:0" TO 
"TRRNSFIL/BRS:!" 

DESCRIPTION 

COPY is a Color Computer Disk BASIC command. 
It copies a complete file from one diskette to 
another diskette under the same or different file 
name, or copies a file to the same diskette under a 
different name, COPY is used to backup a single 
file, or to duplicate a file on the same or different 
diskettes. The file defined by "filenamel" is copied 
as "filename2". Each filename must have an 
extension. The extension follows the main file name 
and is a three-character designator preceded by a 
slash character. The drive number is optional and is 
used only when the copy will be done between two 
different disk drives. 

RELATED COMMANDS 

None 



SYSTEM 



I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III. LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

line#..£OS(expression)... 

EXAMPLES 

1000 R=C0S(X+3. 14159/2) sets variable A 
equal to cosine of X+pi/2 (in radians) 
2000 ND=COS(X*. 01745329) sets variable 
ND equal to cosine of X (in degrees) 

DESCRIPTION 

COS finds the cosine of a given constant, variable, 
or expression. The quantity is assumed to be. in 
radians (180/pi degrees). COS is a "function" and 
may be used anywhere within a BRSIC statement 
as long as the argument is enclosed within 
parentheses. Multiply by .01745329 to convert 
degrees to radians. Standard trigonometric rules 
apply in regard to the sign of the result. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I • 

I, LVL II • 

I, Disk • 

II, 12 

III, LVL I • 
III, LVL III (4,4P)» 
III, Disk (4, 4P) * 
4, 4P, Disk 

CC, BASIC * 

CC, Ext BASIC • 

CC, Disk • 

MC-10 

Model 100 • 

Model 100, Disk » 



FORMAT 

C5AVE "file name" 

C5AVE 

CSAVE "file name", A (Model 100) 

EXAMPLES 

CSfiVE "RATTAIL" 

DESCRIPTION 

The UbRVE command is used to save the current 

BASIC program in RAM on cassette tape. The tape 

must be positioned beyond the leader. Note the 

position of the tape by the tape counter for restart. 

If a "file name" is specified, the contents of RAM 

will be written out as a file called "file name'.' If no 

file name is specified, the name "NONAME" will be 

used. (A file name must be used for the Model 100.) 

Legitimate file names for the Model l/lll are single 

character names. Legitimate names for other 

computers are generally 1 to 6 characters. CLOAD? 

(most systems) may be used to verify that the file 

was written properly. A subsequent CLOAD will 

reload the BASIC program and "overlay" any 

current BASIC program in RAM. See CSAVEtt - 

for systems with more than one cassette. 

Model 100: The A option saves the file in ASCII 

format. 

RELATED COMMANDS 

ULUAD?, CSAVEtt- > 



SYSTEM 

LVL I 

I, LVL II 

Disk 

, 12 

I. LVL I 

I, LVL III (4, 4P) 

I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



CbRVEtt- 



FORMAT 

CSAVEtt -l,"f/7e name" 
CSAVEtt- 2/ 'file name" 

EXAMPLES 

CSAVEtt-, "RATTAIL" 

DESCRIPTION 

The CSAVEtt- command is used to save the 
current BASIC program in RAM on cassette tape 
on those systems that have more than one cassette. 
The tape must be positioned beyond the leader. 
Note the position of the tape by the tape counter for 
restart. If a "file name" is specified, the contents of 
RAM will be written out as a file called "file name" 
If no file name is specified, the name "NONAME" 
will be used. Legitimate file names for the Model I 
are single character names". CLOAD ?8- may be 
used to verify that the file was written properly. A 
subsequent CL0AD8- will reload the BASIC 
program and "overlay" any current BASIC 
program in RAM. 

RELATED COMMANDS 

CLOADtt-, CL0AD78- 



SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 

FORMAT 



uSflVE- array name 

CSflVE* array name, "file name" 




EXAMPLES 

CSflVE* R, ' 
and program 



' PROG1 ' ' save array A 



DESCRIPTION 

CSfiVE* saves the current BfiSIC program in 
memory in similar fashion to CSflVE but also saves 
a specified numeric array. The program and array 
data is loaded with a CLOflD- command. The tape 
must be positioned beyond the leader. Note the 
position of the tape counter for restart. File name is 
optional. If file name is not specified, the file will be 
written without a name and must be read in using a 
CLQRD" without a file name. The array name must 
have been previously defined by a DIM command 
or by use of an array element in the program. 
Legitimate file names are 1 to 10 characters. 

RELATED COMMANDS 

CLOAD*, DIM. CSflVE 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVLI 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

CSflVEM "filename','startaddr,endaddr,execaddr 



;H3000,&H3EEE, 



EXAMPLES 

CSflVEM "SORTPR", 
&H3000 

DESCRIPTION 

CSflVEM is used to save a machine-language 
program in RAM as a cassette file. The "filename" 
parameter is a standard cassette file name. 
CSflVEM can be used to save any binary data in 
RAM whether it is a machine-language program, 
data, or both. The startaddr parameter specifies the 
starting address of the data to be saved. The 
endaddr parameter specifies the end of the data. 
The execaddr specifies the address of the start of 
the program, if applicable, or to a dummy 
parameter. The resulting file is stored as a binary 
file and can be loaded by the CLOflDM command. 
The execaddr is optional on the Model 100. 

RELATED COMMANDS 

CLOflDM, EXEC 



SYSTEM 

LVLI 

LVL II 

Disk 

12 

, LVLI 

, LVL III (4, 4P)' 

. Disk (4, 4P) - 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 




FORMAT 

line#...CSHG(expression)... 

EXAMPLES 

1000 PRINT CSNG ( STtt*NMtt ) convert to sp 
and print 

DESCRIPTION 

CSNG converts a constant, variable, or expression 
to single precision. Single-precision numbers can 
hold up to 7 decimal digits and occupy four bytes 
of storage. CSNG is used whenever it is convenient 
to convert from integer precision or double precision 
to single precision. 

RELATED COMMANDS 

CDBL, CINT 




SYSTEM 

LVLI 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 

FORMAT 

//ne#...C5RLIN.. 



EXAMPLES 

1000 IF C3RLIN=4 THEN CLS 

DESCRIPTION 

CSRLIN finds the current screen line on which the 
cursor is located and returns the line number. Lines 
are numbered (topmost) through 7 (bottommost) 
for the led display or through 23 for the crt or TV 
display in a disk system. 

RELATED COMMANDS 

POS, SCREEN 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk • 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) » 
4, 4P, Disk » 

CC, BASIC 1 p=^%^#^-^= S =^, 

cc, Ext basic -. -- c - -. . ;T;^v> ijT;:;/. 

CC, Disk ,'-•-•— •* ,"•--;- -- v ' > '"' 
MC-10 / ~-ics:r.- ~- - - ',- \ V.^i 
Model 100 ,__ rr-— - .~^-ts^ 

Model 100, Disk 

FORMAT 

line#...c\/D(string)... 
EXAMPLES 

1000 fitt=CVD(BfiL$) convert BfiL$ to 
numeric 

DESCRIPTION 

CVD is used to convert a string variable to a 
double-precision variable. CVD is normally used to 
retrieve a data value from a random-file buffer. The 
typical sequence in retrieving data from a random- 
file buffer is to define the fields in a random-access 
buffer with FIELD, to read in the disk file (see 
GET), and then to retrieve data with CVD, CVI, or 
CVS. CVD is the inverse of MKD$, which is 
normally used to store double-precision data in the 
random-file buffer in character string form. The 
CVD function converts a field from the buffer to 
numeric form. The field is assumed to contain an 8- 
character string created by MKD$. An error or 
invalid results would normally occur for a field size 
other than 8 characters. CVD can also operate on a 
string variable other than a FIELD variable. In this 
case the variable should have been created by 
MKD$ . 

RELATED COMMANDS 
FIELD, MKD$ ; 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

line#...C\ll(string)... 
EXAMPLES 

1000 fi%=CVI (EMP$) convert EMP$ to 

numeric 

DESCRIPTION 

CVI is used to convert a string variable to an 
integer variable. CVI is normally used to retrieve a 
data value from a random-file buffer. The typical 
sequence in retrieving data from a random-file 
buffer is to define the fields in a random-access 
buffer with FIELD, to read in the disk file (see 
GET), and then to retrieve data with CVD, CVI, or 
CVI. CVI is the inverse of MKI$, which is 
normally used to store integer data in the random- 
file buffer in character string form. The CVI 
function converts a field from the buffer to numeric 
form. The field is assumed to contain a 2-character 
string created by MKI$. An error or invalid results 
would normally occur for a field size other than 2 
characters. CVI can also operate on a string 
variable other than a FIELD variable. In this case 
the variable should have been created by MKI$. 

RELATED COMMANDS 

FIELD, MKI$ 




convert ZIP$ to 



SYSTEM 

I, LVL I 

I. LVL II d 

I, Disk 1 

II, 12 1 

III, LVL I 11 
III, LVL III (4, 4P) ill 
III, Disk (4, 4P) 
4, 4P, Disk l ^ 
CC, BASIC i 
CC, Ext BASIC /£ 
CC, Disk • /r* 
MC-10 i m 
Model 100 X~ 
Model 100, Disk ^ 

FORMAT 

line#...CVN(string)... 

EXAMPLES 

1000 fi=CVN(ZIP$j 
numeric 

DESCRIPTION 

CVN is used to convert a string variable to a 
numeric variable. CVN is normally used to retrieve 
a data value from a direct-file buffer. The typical 
sequence in retrieving data from a direct-file buffer 
is to define the fields in direct-file buffer with 
FIELD, to read in the disk file (see GET), and then 
to retrieve data with CVN. CVN is the inverse of 
MKN$, which is normally used to store numeric 
data in the direct-file buffer in character string 
form. The CVN function converts a field from the 
buffer to numeric form. The field is assumed to 
contain a 5-character string created by MKN$. An 
error or invalid results would normally occur for a 
field size other than 5 characters. CVN can also 
operate on a string variable other than a FIELD 
variable. In this case the variable should have been 
created by MKN$ . 

RELATED COMMANDS 

FIELD, MKN$ { 




SYSTEM 

LVL I 
LVL II 

Disk o 

, 12 
I, LVL I 

I. LVL III (4, 4P) 
I, Disk (4, 4P) * 
4, 4P, Disk » 

CC, BASIC '.-" — -— ■ "■•■- " " ~ . 

CC, Ext BASIC — ■r—~.~rr~ r t r—~ 

CC, Disk "i * . V •>"--' V-- • ' ' "\. 

MC-10 - 

Model 100 -~-3= -" - ^ 

Model 100, Disk '---...- r .- ^ 

FORMAT 

Hne#...C\tS(string)... 
EXAMPLES 

1000 R=C VS ( Z I P$ 1 convert Z I P$ to 

numeric 

DESCRIPTION 

CVS is used to convert a string variable to a 
double-precision variable. CVS is normally used to 
retrieve a data value from a random-file buffer. The 
typical sequence in retrieving data from a random- 
file buffer is to define the fields in a random-access 
buffer with FIELD, to read in the disk file (see 
GET), and then to retrieve data with CVD, CVI, or 
CVI. CVS is the inverse of MKS$, which is 
normally used to store single-precision data in the 
random-file buffer in character string form. The 
CVS function converts a field from the buffer to 
numeric form. The field is assumed to contain a 4- 
character string created by MKS$. An error or 
invalid results would normally occur for a field size 
other than 4 characters. CVS can also operate on a 
string variable other than a FIELD variable. In this 
case the variable should have been created by 
MKS$. 
RELATED COMMANDS 

FIELD, MKS$ 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 



FORMAT 

//r/e#...x.xxxxDyy... 

EXAMPLES 

1000 fltt=3. 1415265358979323D+30 
1010 ZZtt=1.76D-5 

DESCRIPTION 

D is used to denote double-precision numbers with 
scientific notation. The format of such a number 
consists of a fraction or mixed number, a "D", and 
a power of ten. The power of 10 may be positive 
(plus sign or no leading sign) or negative (negative 
sign). The fraction or mixed number may consist of 
up to 17 decimal digits (14 in the Model 100). The 
decimal point may be located anywhere within the 
number. The decimal point is optional. The variable 
associated with the double-precision number must 
have a "#" type suffix, or be defined in a DEFDBL 
range (i.e. it must be a double-precision variable). 

RELATED COMMANDS 

tt, DEFDBL 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P)< 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 



FORMAT 

linett DRTR item 1, item 2, item 3, 
item 4, ... item N 

EXAMPLES 

1000 DRTR 5.2, 2, -3, 5, -1 defines a list 

of 6 numeric items 

2000 DRTR ORRNGE, PERCH, PEAR defines a 

list of three string items' 

3000 DRTR 5, PLUM, -2, 7. 58, 6, PERR, 

-5,-10.2 defines a mixed list 

DESCRIPTION 

DRTR is used to define a list of numeric or string 
values to be used in the program. More than one 
DRTR statement results in one large list. Values can 
be read by using the READ command. RESTORE 
is used to "reset the pointer" to the beginning of 
the list. The following statements read 1, -2.5, and 
PERR into variables A, B, and A$: 

1000 DRTR 1, -2. 5, PERR establishes list 
1010 READ R , B , fl$ reads values 
1020 RESTORE resets pointer 

Double quotes must enclose a string value if the 
string has leading blanks, commas, or colons. 

RELATED COMMANDS 

RERD, RESTORE 



SYSTEM 




, LVLI 
- LVL II 

, Disk I! 

I. 12 • j 

II, LVL I I 
II, LVL III (4, 4P) j 
II, Disk (4, 4P) j 

4, 4P, Disk • I 

CC, BASIC 

CC, Ext BASIC ~ " ~" 

cc, Disk ;_;.-.-. ;~w_v..> -"- -_' ,-' x- 

MC-10 .-■- 

Model 100 • ir 

Model 100, Disk ° 

FORMAT 

//ne# ...DATES. . . 
EXAMPLES 

1000 PRINT "TODAY'S DATE 15"; 
DATES 

DESCRIPTION 

DATES returns the current date and information 
about the date as a text string. When TRSDOS is 
started up, the operator enters the current date. 
DATE'S returns this information in BASIC. The 
format of the DATES string for the Model II is 
WWWMMMDDYYYYJJJXXY where WWW is the day of 
the week, MMM is the month, DD is the numbered 
day of the month, YYYY is the year, JJJ is the Julian 
day (numbered day of the year), XX is the 
numbered month of the year, and Y is the 
numbered day of the week. A typical string returned 
by DATES is: WedDec301981364122. Weeks start 
with Monday, the Oth day; all other parameters 
count from 1. The format of the DATES string for 
the Models 100 and 4 is MM/DD/YY. 
RELATED COMMANDS 
None 



SYSTEM 




I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4.4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk • 

FORMAT 

DAY$=... 
//ne#... DAYS 



EXAMPLES 

1000 PRINT "TODAY IS " ; DAYS 

DESCRIPTION 

When the system is first started up, you can enter 
the current day of the week in direct mode by 
entering DAY$= followed by a three letter day of 
the week — Mon, Tue, Wed, Thu, Fri, Sat, or Sun. 
Thereafter, the system will maintain the day of the 
week and you can use the DAYS function to 
automatically produce the current day of the week 
for reports or other functions. The string returned in 
using DAYS will be a three-character string as on 
entry. 

RELATED COMMANDS 

DATES 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//7?e# DEF FHname(argl,arg2,...,argn)=formula 

EXAMPLES 

1000 DEF FNZ(fi,B)=SQR[fi*fi+B*B) 

DESCRIPTION 

DEF FN is used to define a function. A function is 
a predefined operation that can be "invoked" by 
using the characters "FN" followed by the function 
name. Functions are useful if the same basic 
operation is repeated many times within a BfiSIC 
program. In the above example, suppose that the 
operation SQR ( fi*fi+B*B ) were to be repeated at 
100 different places in a BfiSIC program. Defining 
it as DEF FNZ would permit code such as 

"2000 PRINT FNZ(101,50)"; the "FNZ" 

would execute the function called 
"Z" and perform SQR(101*101+50*50). The 
name parameter may be any variable name; any 
variable type suffix may be used, such as A%, A!, or 
A$. The arg parameters define the arguments to be 
used in the function; they are "dummies" in the 
DEF FN command and serve only as "place 
markers" for definition of the procedure. The 
dummies do not affect variable values. Only one 
argument may be used in the Color Computer. 
RELATED COMMANDS 
None I 



SYSTEM 




I, LVL I 

I, LVL II • 

I, Disk » 

II, 12 * 

III, LVL I 

III, LVL III (4, 4P)» 
III, Disk (4, 4P) ° 
4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC --" .---.-.r ~^ 

CC, Disk :' ' V 

MC-10 .- . - "--• . ;;', f 

Model 100 • - ■ 

Model 100, Disk • 

FORMAT 

line# DEFDBL letter 
lineff DEFDBL letter range 

EXAMPLES 

1000 DEFDBL fi-B 
3000 DEFDBL I-K 

DESCRIPTION 

DEFDBL defines all variables within the specified 
letter range as double-precision numeric variables 
(17 decimal digits of precision stored, 16 displayed 
in most systems). Variables with type suffixes of "%',' 
"!',' "$" or "E" however, are not affected. The letter 
range defines a range of letters for the beginning 
letter of the variable. A letter range of l-K, for 
example, would include I, J, and K. After definition 
of this letter range by a DEFDBL, all variables 
beginning with I, J, or K would automatically be 
assumed to be double-precision variables, except for 
those with type suffixes. DEFDBL is a convenient 
way to define a range of variables as double- 
precision variables without having to define each 
variable separately with the # type suffix. DEFDBL 
would normally be used at the beginning of a 
BfiSIC program. 

RELATED COMMANDS 

!,»,$,*, DEF I NT, DEFSNG, DEFSTR, E 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL III (4. 4P) • 
III, Disk (4, 4P) • 
4, 4P, Disk * 

CC, BASIC - _. J . . :_-..-. 

CC, Ext BASIC ; . 

CC, Disk 

MC-10 

Model 100 8 — 

Model 100, Disk • 

FORMAT 

linett DEFINT /effer 
linett DEFINT letter range 

EXAMPLES 

1000 DEFINT A-B 
3000 DEFINT I-K 

DESCRIPTION 

DEFINT defines all variables within the specified 
letter range as integer variables (capable of holding 
■32768 to +32767). Variables with type suffixes of 
"#',' "!',' "D" "$',' or "E" however, are not affected. 
The letter range defines a range of letters for the 
beginning letter of the variable. A letter range of l-K, 
for example, would include I, J, and K. After 
definition of this letter range by a DEFINT, all 
variables beginning with I, J, or K would 
automatically be assumed to be integer variables, 
except for those with type suffixes. DEFINT is a 
convenient way to define a range of variables as 
integer variables without having to define each 
variable separately with the % type suffix. DEFINT 
would normally be used at the beginning of a 
BASIC program. 
RELATED COMMANDS 

!,tt,$,%,D, DEFDBL, DEFSNG, 
DEFSTR, E 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk « 

II, 12 * 

III, LVL I 

III, LVL III (4, 4P) • 
III, Disk (4, 4P) • 

4, 4P, Disk * _ 

CC, BASIC 

CC. Ext BASIC r - 

CC, Disk , '- - -- " --;•'-[' '< " ; ^ 

MC-10 

Model 100 • ' ' ---- ._. -. 

Model 100, Disk • t 

FORMAT 

linett DEFSNG letter 
linett DEFSNG letter range 
EXAMPLES 
1000 DEFSNG A-B 
3000 DEFSNG I-K 
DESCRIPTION 

DEFSNG defines all variables within the specified 
letter range as single-precision variables (7 decimal 
digits of precision stored, 6 displayed). Variables 
with type suffixes of "%',' "#',' "D" or "$',' however, 
are not affected. The letter range defines a range of 
letters for the beginning letter of the variable. A 
letter range of I-K, for example, would include 
and K. After definition of this letter range by a 
DEFSNG, all variables beginning with I, J, or K 
would automatically be assumed to be single- 
precision variables, except for those with type 
suffixes. Single-precision variables are the "default" 
mode for BASIC variables, and DEFSNG would 
not have to be used except to redefine variables 
that were previously assigned to other variable types. 
RELATED COMMANDS 

!, 8, $, *, D, DEFDBL, DEFINT, 
DEFSTR, E 



I, J, 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk • 

II, 12 9 

III, LVL I 

III, LVL III (4, 4P) • 
III, Disk (4, 4P) • 
4, 4P, Disk 9 

CC, BASIC 

CC, Ext BASIC 

CC, Disk ; 

MC-10 

Model 100 • 

Model 100, Disk • 

FORMAT 

lineti DEFSTR letter 
linett DEFSTR letter range 
EXAMPLES 

1000 DEFSTR fi-B 
3000 DEFSTR I-K 
DESCRIPTION 

DEFSTR defines all variables within the specified 
letter range as string variables. Variables with type 
suffixes of "%',' "!',' "#',' "D" or "E" however, are not 
affected. The letter range defines a range of letters 
for the beginning letter of the variable. A letter 
range of l-K, for example, would include I, J, and K. 
After definition of this letter range by a DEFSTR, 
all variables beginning with I, J, or K would 
automatically be assumed to be string variables, 
except for those with type suffixes. DEFSTR is a 
convenient way to define a range of variables as 
string variables without having to define each 
variable separately with the $ type suffix. DEFSTR 
would normally be used at the beginning of a 
BASIC program. 
RELATED COMMANDS 

!, tt, $, %, D, DEFINT, DEFDBL, 
DEFSNG, E 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III. Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

//'/je# DEFUSRn=address 

EXAMPLES 

1000 DEFU3R3=&H8000 define subroutine for 
Model I 

DESCRIPTION 

DEFUSR is used to define the location of a 
machine-language subroutine. The subroutine 
consists of machine language for the system in use. 
The n parameter in the DEFUSR command may be 
any number from through 9; this allows up to 10 
machine-language subroutines to be defined for 
interface to BfiSIC programs. The address value on 
the right-hand side of the DEFUSR command is the 
starting point for the machine-language code. The 
machine-language subroutine may consist of any 
number of instructions. The subroutine is called by 
the uSRn call, in which n matches the n of the 
DEFUSR. USR3, for example, would match the 
DEFUSR3 definition. 

RELATED COMMANDS 

USRn 




SYSTEM 

I, LVLI 
I, LVLII 

I, Disk 

II, 12 

III, LVLI 

III, LVLIII(4, 4P) 
III, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC ^J^z^-^swEEz. 

CC, Ext BASIC • j^=====™ 

CC, Disk • ,'^" ~>. w-^^ "s"^L'i 

MC-10 

Model 100 » ; " h=~^L=JT J 

Model 100, Disk t _._ _.__„_._ 

FORMAT 

DEL - 

DEL linen-linen 

DEL //ne#- 

DEL -linen 

line^ DEL linen-line^ 

EXAMPLES 

DEL 100- delete lines 100 through end 

DESCRIPTION 

DEL deletes a range of BASIC lines from 
The BASIC interpreter "repacks" the BfiSIC 
program to utilize the deleted area. If the "DEL-" 
format is used, the entire program is deleted from 
memory. If the "line#-line#" format is used, all lines 
including the start and end lines are deleted. If the 
"■line#" format is used, all lines from the beginning 
of the program through the specified end number 
are deleted. If the "line#-" format is used, all lines 
from the specified start number through the end of 
the program are deleted. DELETE may be used to 
delete lines from the command mode for program 
editing purposes, or to delete program lines 
"dynamically" to release portions of BASIC 
programs that are no longer needed to create room 
for variables. 

RELATED COMMANDS 

None i 




SYSTEM 

LVL I 
LVL II 

Disk • 

, 12 * 

I, LVL I 

I, LVL III (4. 4P)» 
I, Disk (4, 4P) 9 
4, 4P, Disk » 

CC, BASIC ' _ ■ 

CC, Ext BASIC -:.'"-' 

CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

DELETE linen-linen (in command mode) 

DELETE linen 

DELETE -linen 

linen DELETE linen-linen 

EXAMPLES 

DELETE 100- delete lines 100 through end 

DESCRIPTION 

DELETE deletes a range of BASIC lines from 
RAM. The BASIC interpreter "repacks" the BASIC 
program to utilize the deleted area. If the "line#- 
line#" format is used, all lines including the start 
and end lines are deleted. If the "-line#" format is 
used, all lines from the beginning of the program 
through the specified end line number are deleted. 
If the "line#" format is used, the specified line 
number is deleted. DELETE may be used to delete 
lines from the command mode for program editing 
purposes, or to delete program lines "dynamically" 
to release portions of BASIC programs that are no 
longer needed to create more room for variables. 
RELATED COMMANDS 
None 







SYSTEM 

I, LVL I 

I, LVL II « 

I, Disk « 

II, 12 * 

III, LVL I 

III, LVL III (4, 4P)® 

III, Disk (4, 4P) ® 

4, 4P, Disk » 

CC, BASIC « 

CC, Ext BASIC ° 

CC, Disk « 

MC-10 » 

Model 100 « f 1 — - -'- ' ._•-.-__- _£=.. 

Model 100, Disk ® l 

FORMAT 

lineti DIM name(diml) 
linett DIM name(diml,dim2) 
//ne# D I M name(diml, dim2, . . . dimk) 
EXAMPLES 

1000 D I M ft% ( 10 , 40 1 11 by 41 int array 
DESCRIPTION 

DIM is used to allocate space for a BASIC array. 
The name parameter names an integer, single 
precision, double precision, or string array (numeric 
or string in the Color Computer and MC-10). The 
name must adhere to the name conventions for the 
variable type involved. The dimensions are one less 
than the number of elements for each dimension of 
the array. The DIM statement only names and 
allocates the array; it does not initialize it to any 
value, although the elements are zeroed on power 
up automatically. Elements within the array are 
accessed by using the element number with the 
array name. The first element of a two-dimensional 
array might be A(0,0), the second A(0,1), and so 
forth. The last element in the array has the element 
numbers defined in the DIM statement. Each array 
element requires the same memory that a variable 
of the same type would require. 

RELATED COMMANDS 

None ( 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I. 12 

II, LVL I 

II. LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

DIR 
DIRcfr/Ve# 

EXAMPLES 

DIR0 

DESCRIPTION 

DIR displays the disk directory of the disk drive 
number specified. If the drive number is not used, 
DIR will display the directory of the current disk 
drive (last specified by DRIVE) or drive 0, the 
default drive number if DRIVE has not been used. 
The directory will be displayed with the file name, 
extension of the file (BAS, BIN, DfiTfi, or other 
user- or system-specified extension), file type 
(0=BASIC data file, 1=BRSIC data file, 
2=machine-language file, 3=editor source file), file 
format (A=ASCII, B=binary), and file length 
in granules (2304 bytes). A typical display line 
might be: 

RCCTS DRTR IBS 

indicating file ACCTS/DATA, a BASIC data file in 
binary that is 5 granules or 11520 bytes long. 

RELATED COMMANDS 

None 




SYSTEM 

I. LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 

cc. basic f" „"r*_ j " viuu _ " * "-> 

CC, Ext BASIC • • •- ^•V 7 l f?7-~.l''T r V-. • 

CC, Disk • '~"\ - v >- -- -' « 

MC-10 '-' loir..-;:- '- - )'/■: ,.\-J 

Model 100 - — 

Model 100, Disk 

FORMAT 

//'ne# DRflN "string" 
EXAMPLES 

1000 DRflN "BM128,96;M0,0;M255,2" 
DESCRIPTION 

The DRflN command is used to draw a series of 
connected line segments in various lengths and 
directions. The line segments may be drawn in 8 
directions in any length. The "string" parameter 
specifies a string of DRflN subcommands, each 
defined by a single text character. To draw a line of 
n pixels up, 45 degrees, right, 135 degrees, down, 
215 degrees, left, or 325 degrees, use the text 
strings "Un;", "En;", "Rn;", "Fn;", "Dn;", 
"Gn;","Ln;", or "Gn;", where n is the number of 
pixels. To move to any x,y coordinate, use the text 
string "Mx,y;" where x and y are 0-255 and 0-191, 
respectively. Precede x and y with "+" or "-" for 
moves relative to the current position. Use "B" after 
the M or "B;" at any time for a "blank" line. Use 
"N" before the motion command for a "no update" 
of the position. Use "Cn;" to change color. Use 
"Ax;" for rotates of 0, 90, 180, or 270 degrees 
(x=0, 1,2,3). Scale the draw by "Sx;" where x equals 
a scale factor of 1 through 62. Execute a substring 
by "X(string);". 

RELATED COMMANDS 
None i 



SYSTEM 

LVL I 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

DRIVE driveH 

EXAMPLES 

DRIVE 1 

DESCRIPTION 

DRIVE is a Color Computer Disk BASIC command. 
It is only used on systems with more than one drive 
to change the "default" disk drive number. The 
default drive number is used when the drive 
number is not specified in a filename (the standard 
filename format is name/extension:drive number). 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

linetf DSKI$ drive#,track,sector,string var 1, string 
var 2 

EXAMPLES 

1000 D3KIS 0,12,3,R3,B$ drive O.track 12, 
sector 3 

DESCRIPTION 

DSKI$ is a Color Computer Disk BRSIC command 
that permits direct access of a specified physical 
location on disk. It is used to process special files 
created by the system user or to process disk 
contents without using disk "file manage'.' The 
drive# parameter specifies the drive, the track 
parameter one of the diskette tracks (0 through 34), 
the sector number one of the sectors within the 
track (0 through 17). The two string variables 
receive the 256 bytes of data from the track, sector. 
String variable 1 receives the first 128 bytes from 
the sector, while string variable 2 receives the 
second 128 bytes. Data from the disk may or may 
not represent valid ASCII characters, depending 
upon the data output to the disk. 

RELATED COMMANDS 

DSKOS i 



SYSTEM 




, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC '-. -_ -.-:- ~ 

CC, Disk \ -'/'•'•■„ \\~ 

mc-io ■■".' " _. - : -..;•'• 

Model 100 ... _ 

Model 100, Disk • ■ _ . ■ 

FORMAT 

linett... DSKIS (drive#,track#,sector#,switch) 

EXAMPLES 

1000 R$=DSKI$(0,7,5,1 ] read half of sector 

DESCRIPTION 

DSKIS is a Model 100 BRSIC command that 
permits direct access of a specified physical location 
on the disk. It is used to process special files 
created by the system user or to process disk 
contents without using disk "file manage". The 
drive# parameter specifies either drive or 1. The 
track parameter is through 34. The sector 
parameter is a sector number on the track of 
through 17. The "switch" is either or 1. If 0, the 
first 128 bytes of the sector are returned, usually to 
a string variable as in the example above. If the 
switch is 1, the second 128 bytes of the sector are 
returned. Data from the disk may or may not 
represent valid ASCII characters, depending upon 
the data output to disk. 

RELATED COMMANDS 

DSKOS 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

DSKINlcfr/Ve# 

EXAMPLES 

DSKINI0 

DESCRIPTION 

DSKINI is a Color Computer Disk BfiSIC 
command that "formats" a diskette in the specified 
drive number. The formatting process prepares the 
diskette for receiving data files and is a necessary 
process before doing any BASIC disk operations. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

linett DSKOS drive#,track,sector,string 1, string 2 
EXAMPLES 

1000 DSI<0$ 0,12,3,A$,B$ drive 0,track 12, 
sector 3 

DESCRIPTION 

DSI<0$ is a Color Computer Disk BASIC command 
that permits direct access of a specified physical 
location on disk. It is used to create special files 
defined by the system user. The drive# parameter 
specifies the drive, the track parameter one of the 
diskette tracks (0 through 34), the sector number 
one of the sectors within the track (0 through 17). 
The two string variables define the 256 bytes of 
data to be output to the track, and sector. String 
variable 1 defines the first 128 bytes for the sector, 
while string variable 2 defines the second 128 
bytes. Literal strings may be used in either case. 
Data in the variables may or may not represent 
valid ASCII characters, depending upon the data to 
be output. DSKI$ is normally used to input the 
disk data output by DSI<0$. 

RELATED COMMANDS 

DSKI$ 




SYSTEM 

, LVLI 
, LVLII 
, Disk 

I, 12 

II, LVLI 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk .. '">. r ; - . - : ! ■ ,. 

MC-10 -' - --_-• V , -f \ 

Model 100 = - - — ~: 

Model 100, Disk • l 

FORMAT 

lineti ...Dbl<u$ 

drive#,track#,sector#,switch,expression 
EXAMPLES 

1000 R$=DSI<0$ 0,7,5,1,A$ write half of sector 
DESCRIPTION 

DziKus is a Model 100 BRSIC command that 
permits direct access of a specified physical location 
on the disk. It is used to process special files 
created by the system user or to process disk 
contents without using disk "file manage". The 
drive# parameter specifies either drive or 1. The 
track parameter is through 34. The sector 
parameter is a sector number on the track of 
through 17. The "switch" is either or 1. If 0, the 
first 128 bytes of the sector are to be written. If the 
switch is 1, the second 128 bytes of the sector are 
to be written. The "expression" is a string variable 
or constant that contains the data to be written on 
half of the disk. The number of characters in the 
string may be less than 128 characters; in this case 
the disk data is "padded out" to the right with 
(null) codes. Writing to one half of the sector does 
not affect the remaining half. Data written does not 
have to be valid ASCII characters. 

RELATED COMMANDS 

DSKI$ t 



SYSTEM 

I, LVL I 

I, LVL II « 

Disk « 

, 12 « 

I, LVL I 

I, LVL III (4,4P)« 

I, Disk (4, 4P) i 

4, 4P, Disk « 
CC, BASIC 

CC, Ext BASIC * 

CC, Disk « 

MC-10 « 

Model 100 « 

Model 100, Disk « 

FORMAT 

line#...x.xxxxEyy 

EXAMPLES 




1000 R=l. 
1010 ZZ! = 



1112E-5 
■3.567E+34 



DESCRIPTION 

E is used to denote scientific notation for single- 
precision numbers. The format consists of a fraction 
or mixed number, followed by an E, followed by a 
power of ten. The power of ten may be positive 
(plus sign or no sign) or negative (minus sign). The 
fraction or mixed number may be any number of 
decimal digits up to 7, with the decimal point 
located anywhere within the digits. The decimal 
point is optional. The variable associated with the E 
format must be a single-precision variable. This is 
the default condition for BASIC variables and no 
"!" suffix is necessary unless the variable name falls 
in a DEFDBL or DEFSTR range. 

RELATED COMMANDS 

!, DEFSNG 




SYSTEM 

, LVLI 

, LVL II • 

, Disk • 

I, 12 • 

II, LVL I 

II, LVL III (4. 4P) • 
II, Disk (4, 4P) • 

4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC • 

CC, Disk • 

MC-10 .'. ■■£, 

Model 100 '- . .-... . ■'■•'■„,. 

Model 100, Disk 

FORMAT 

EDIT linett (in command mode) 
EDIT, (except Color Computer) 

EXAMPLES 

EDIT 1000 edit line #1000 
EDIT. edit last line entered, altered, or in 
error 

DESCRIPTION 

EDIT is a command mode command that invokes 
the BASIC interpreter Edit mode. The edit mode is 
used to modify BASIC program lines by adding, 
deleting, or modifying characters to the line. Any 
existing line number may be specified in the EDIT 
command. After the EDIT command has been 
given, the BASIC interpreter will display the line 
number and will position the cursor to the first 
character of the line. Subsequent Edit mode 
commands will allow editing of the line. To get out 
of the Edit mode, press ENTER. The 
"EDIT." format displays the last line entered, 
altered, or in which an error occurred. Entering the 
Edit mode automatically clears all variables. If 
BASIC encounters a syntax error during program 
execution, it automatically enters the Edit mode for 
the erroneous line. Entering "Q" will allow you to 
Quit the Edit mode and examine variables and 
program conditions. 
RELATED COMMANDS Edit Mode Subcommands 




SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk ' 



FORMAT 

EDIT 

EDIT linett-linett 

EDIT ~//ne# 

EDIT linett- 

EDIT. 

EXAMPLES 

EDIT 100-150 edit lines 100-150 
DESCRIPTION 

Using an EDIT command from BASIC enters the 
text editor. While in the text editor, all normal text 
editing functions can be performed. Pressing the F8 
function key returns to BASIC. EDIT alone can 
be used to edit the entire BASIC program. If only 
a portion of the program is to be edited, however, 
the other EDIT formats may be used. EDIT with a 
period allows and edit of the line last edited, 
entered, or listed (the "current" line). EDIT with a 
range of lines allows an edit of a group of lines. A 
dash before or after a single line number indicates 
"all lines up to" or "all lines after". 

RELATED COMMANDS 

None 




SYSTEM 

LVL I 

LVL II <• 

Disk • 

12 

, LVL I 

, LVL III (4, 4P)» 

, Disk (4, 4P) «• 
4, 4P, Disk e 

CC, BASIC 

CC, Ext BASIC » i 
CC, Disk • I 

MC-10 i- 

Model 100 
Model 100, Disk 

FORMAT 

Edit Mode: A keypress 



EXAMPLES 

1000 FOR 1=1 Tfi J- (pressing A cancels 
changes and restarts the Edit) 

DESCRIPTION 

The Edit mode is entered by the EDIT line# 
command. The A subcommand is used to cancel all 
changes to the line that have been made and to 
restart the Edit at the beginning of the line. The A 
subcommand differs from the Q subcommand in 
that the Q subcommand cancels changes and Quits 
the Edit mode, while the A subcommand cancels 
changes but keeps the Edit mode in force. In the 
example above, the result would have been 

1000 FOR I=J Tfi J 
1000 - 

The line can now be reedited with the proper 
changes. 

RELATED COMMANDS 

Edit Mode Subcommands 




SYSTEM 

LVL I 

LVL II 

Disk 

12 

, LVL I 

, LVL III (4.4P)' 

, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

Edit Mode: Backspace keypress (backspace is left 

arrow) 

Edit Mode: nBackspace keypress 

EXAMPLES 

1000 FOR 1=1 TO -• (pressing 5 and 
Backspace backspaces to the left 5 characters on 
the line) 

DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. To backspace 
the cursor to the left one character position, press 
Backspace (left arrow). To backspace to the left 
more than one character position, enter a number of 
1 through n and press Backspace. In the example 
above, 5 was entered, followed by Backspace; this 
positioned the cursor 5 character positions to the 
left. The 5 characters previously displayed were 
unaltered but erased from the display. Backspace 
can be used to space back along the line until the 
proper place is found to insert, delete, or modify 
characters by the other Edit Mode subcommands. 
RELATED COMMANDS 
Edit Mode Subcommands 




SYSTEM 

LVL I 

LVL II • 

Disk • 

, 12 • 

I, LVL I 

I, LVL III (4. 4P) • 

I, Disk (4, 4P) * 

4, 4P, Disk • 

CC, BASIC - • " " ■-'-^----•" t 

CC, Ext BASIC « .'----- ~.r:r^fr~- ' \ 

CC, Disk • .,: -.•:".-_". 7 ">>-'':' ' '' 'V" - 

MC-io - ~-~'-- ,v - ;-*- - l '; , - *> 

Model 100 f — J.-=^r--" - . 

Model 100, Disk l " 

FORMAT 

Edit Mode: C keypress 
Edit Mode: nC keypress 
EXAMPLES 

1000 FOR 1=1 TO - (pressing 5 and C begins 
change operation for next 5 characters) 
DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. The C 
subcommand is used to change 1 or more 
characters to new characters. To change the current 
character at the cursor position, press C followed by 
the new character. To change n additional 
characters, enter a number of 1 through n and 
press C. Then type the characters to replace the 
number specified. In the example above, 5 was 
entered, followed by C. If (K-5) was then entered, 
the new line up to that point would read 
1000 FOR 1=1 TO (K-5)- 
The number of characters for the change must be 
exactly equal to the number replaced. 
RELATED COMMANDS 
Edit Mode Subcommands 



SYSTEM 



LVL I 

LVL II 

Disk 
, 12 
I, LVL I 

I, LVL III (4, 4P) 
I. 




Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC _ 

CC, Ext BASIC 9 ,'.—. ' .-^-.-r-7'-' 

CC, Disk « ;_/"_-.-,/_"-"'_":". 

mc-io -— -:™-- - - --■ '.; : < ' 

Model 100 '■ --=^- 

Model 100, Disk 

FORMAT 

Edit Mode: D keypress 
Edit Mode: nD keypress 
EXAMPLES 

1000 FOR 1=1 TO - (pressing 5 and D deletes 
next 5 characters) 

DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. The D 
subcommand is used to delete 1 or more 
characters. To delete the current character at the 
cursor position, press D. The character deleted will 
be displayed bracketed by exclamation points or 
back slashes (Model 4). To change n additional 
characters, enter a number of 1 through n and 
press D. The characters deleted will be displayed 
bracketed by exclamation points or back slashes 
(Model 4). In the example above, 5 was entered, 
followed by D. The display would show: 
1000 FOR 1=1 TO ![K-5j !- 
The characters (K-5) would have been deleted from 
the line. 

RELATED COMMANDS 

Edit Mode Subcommands 



SYSTEM 

, LVLI 
, LVL II 
, Disk 

I. 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

Edit Mode: E keypress 

EXAMPLES 

1000 FOR 1=1 TO J- 



STEP - (press E) 



DESCRIPTION 

The Edit mode is entered by the EDIT line# 
command. Pressing the E key while in the Edit 
Mode records all changes made while in Edit mode 
and returns to the BASIC interpreter command 
mode. E is not active while in any Insert mode such 
as I, X, or H. E is logically equivalent to pressing 
ENTER. 

RELATED COMMANDS 

Edit Mode Subcommands 



SYSTEM 

LVL I 
LVL II 

Disk a 

, 12 • 

I, LVL I 

I, LVL III (4, 4P) • 
I, Disk (4 r 4P) • 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk • 

MC-10 
Model 100 
Model 100, Disk 



Edit Mode 
ENTER 



FORMAT 

Edit Mode: ENTER keypress 

EXAMPLES 

1000 FOR 1=1 TO J -5 STEP 
ENTER) 



(press 



DESCRIPTION 

The Edit mode is entered by the EDIT line# 
command. Pressing the ENTER key while in the 
EDIT mode records all changes made while in Edit 
mode and returns to the BASIC interpreter 
command mode. 

RELATED COMMANDS 

Edit Mode Subcommands 



SYSTEM 

LVLI 

LVLII 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

Edit Mode: ESC keypress 



EXAMPLES 

1000 FOR I 

Insert mode) 



=1 TO - (pressing ESC resets the 



DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. Text may be 
inserted by the I, X, or H subcommands. While in 
the edit portion of these subcommands, characters 
are entered until the ESC key is pressed. The Insert 
submode is then ended. ESC should be pressed at 
any time to "reset" the current Edit mode to a 
known condition. 

RELATED COMMANDS 

Edit Mode Subcommands I, H, X 




SYSTEM 

LVLI 

LVL II * 

Disk a 

, 12 
I, LVL I 

I. LVL III (4. 4P) • 
I. Disk (4, 4P) • 
4, 4P, Disk « 

CC, BASIC 

CC, Ext BASIC » - 

CC, Disk • --■>.•.' - 1 

MC-10 .-" : -_-: -■' 

Model 100 
Model 100, Disk 

FORMAT 

Edit Mode: H keypress 

EXAMPLES 

1000 FOR i=- (pressing H deletes remainder of 
line and invokes the Insert mode) 

DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. To delete the 
remainder of the line from the current cursor 
position, press H. This "Hacks off" the remainder of 
the line and invokes the Insert mode. In the 
example above, pressing H and then entering "2 TO 
K-6" would have resulted in the following line: 

1000 FOR 1=2 TO K-6- 

At this point the Insert mode would still be in force 
and additional characters could be added to the end 
of the line. To terminate the Insert mode, press 
SHIFT, up arrow together, or press ENTER. ENTER 
enters the current changes and returns to the 
command mode, while SHIFT, up arrow terminates 
the Insert mode but keeps the Edit mode active. 

RELATED COMMANDS 

Edit Mode Subcommands 



Edit 
Mode I 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL 111(4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

Edit Mode: I keypress 

EXAMPLES 

1000 FOR 1=1 TO - (pressing I enters Insert 
submode) 

DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. To insert 
characters at any point press I. All characters 
entered from that point until the SHIFT, up arrow 
keys were pressed simultaneously would be entered 
into the line. In the example above, if the original 
line was "1000 FOR 1=1 TO 100", entering I 
followed by "J-" and then SHIFT, up arrow would 
result in a line consisting of: 

1000 FOR 1=1 TO J- 

The SHIFT, up arrow would not terminate the Edit of 
the line; the cursor would be positioned after the 
last character inserted and the remainder of the line 
would not be visible. Pressing the ENTER key will 
also terminate the Insert. 

RELATED COMMANDS 

Edit Mode Subcommands 



SYSTEM 




LVL I 
LVL II 

Disk ® 

, 12 * 

I, LVL I 

I, LVL III (4, 4P) • 
I, Disk (4, 4P) » 
4, 4P, Disk * 

CC, BASIC 

CC, Ext BASIC » ;' ~-~--r-r?rc.s?.fprr:'r; 

CC, Disk * vt ~ -..'_-*~- v. ; '~7- 

MC-10 ;* 'yi^i-iv--- . ",,V .'r 

Model 100 f — ~- ~ : '^ '- '" ■ 

Model 100, Disk 

FORMAT 

Edit Mode: Kc keypress 
Edit Mode: nKc keypress 
EXAMPLES 

1000 - (pressing 2, K, and : searches for the 
second occurrence of the character ":" and kills all 
characters to that point) 
DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. The K subcommand is used to search for 
the first or "nth" occurrence of a single character 
and to delete all characters preceding the search 
character from the current cursor position. To 
search for the first occurrence of a character, press 
K followed by the search character. The cursor will 
move to the right until positioned over the character 
and delete all characters from the cursor position to 
that point. The deleted text will be displayed 
bracketed by exclamation points. The search 
character will not be displayed. To search for the 
nth occurrence of a character, enter a number from 
1 to n, enter a K, and enter the search character. 
The cursor will be positioned over the nth 
occurrence of the character with a similar delete 
action. 

RELATED COMMANDS 

Edit Mode Subcommands 




(pressing L displays remainder of 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P)® 
III, Disk (4, 4P) a 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk ° | 

MC-10 I 

Model 100 I 

Model 100, Disk 

FORMAT 

Edit Mode: L keypress 

EXAMPLES 

1000 FOR I=- 

line) 

DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. To display the 
remainder of the line, press L The remainder of the 
line will be displayed and a new line will be started 
with the cursor positioned on the first character of 
the new line. In the example above, the result would 
have been 

1000 FOR 1=1 to J-5 STEP 3 
1000 - 

The Edit Mode L subcommand lets you see the 
remainder of the line without having to space along 
the line. The L subcommand is not active while in 
an insert mode such as I, X, or H. 

RELATED COMMANDS 

Edit Mode Subcomma/ids 



SYSTEM 



LVL I 

LVL II 

Disk 

12 

I, LVL I 

I. LVL III (4, 4P) 
I, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




(pressing Q cancels 



FORMAT 

Edit Mode: Q keypress 

EXAMPLES 

1000 FOR 1=1 Tfl d- 
changes and Quits the Edit) 

DESCRIPTION 

The Edit mode is entered by the EDIT line# 
command. The Q subcommand is used to cancel all 
changes to the line that have been made and to 
Quit the Edit. The Q subcommand differs from the- A 
subcommand in that the Q subcommand cancels 
changes and Quits the Edit mode, while the A 
subcommand cancels changes but keeps the Edit 
mode in force. In the example above, the result 
would have been 

1000 FOR I=J Tfi J 

(BASIC command mode) 

The Q subcommand is used when changes have 
been erroneously made to a BASIC program line. 

RELATED COMMANDS 

Edit Mode Subcommands 




SYSTEM 

I, LVL I 

I, LVL II * 

I, Disk «> 

II, 12 » 

III, LVL I 

III, LVL III (4, 4P)° 
III, Disk (4, 4P) * 
4, 4P, Disk * 

CC, BASIC -_.' ;.__*_ - 

CC, Ext BASIC ° r .-!; \ --, 

CC, Disk s : .-'-■•■•<'-•-, \ r ">-; 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

Edit Mode: Sc keypress 
Edit Mode: nSc keypress 
EXAMPLES 

1000 - (pressing 2, C, and searches for the 
second occurrence of the letter 0) 

DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. The S 
subcommand is used to search for the first or "nth" 
occurrence of a single character. To search for the 
first occurrence of a character, press S followed by 
the search character. The cursor will move to the 
right until positioned over the character. The 
character will not be displayed. To search for the 
nth occurrence of a character, enter a number from 
1 to n, enter an S, and enter the search character. 
The cursor will be positioned over the nth 
occurrence of ther character. The line up until the 
nth occurrence will be displayed. If the character is 
not found in the search, the entire line will be 
displayed with the cursor positioned at the end. 

RELATED COMMANDS 

Edit Mode Subcommands 



SYSTEM 

LVL I 

LVL II » 

Disk « 

12 o 

, LVL I 

, LVL III (4. 4P)» 
, Disk (4, 4P) « 

4, 4P, Disk « 

CC, BASIC 

CC, Ext BASIC o 

CC, Disk e 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

Edit Mode: SHIFT, up arrow 

EXAMPLES 

1000 FOR 1=1 TO - (pressing SHIFT, up arrow 
resets the Insert mode) 

DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. Text may be 
inserted by the I, X, or H subcommands. While in 
the edit portion of these subcommands, characters 
are entered until the SHIFT, up arrow keys are 
pressed simultaneously. The Insert submode is then 
ended. SHIFT, up arrow should be entered at any 
time to "reset" the current Edit mode to a known 
condition. 

RELATED COMMANDS 

Edit Mode Subcommands I, H, X 




SYSTEM 

LVLI 

LVL II « 

Disk • 

, 12 • 
I, LVL I 

I. LVL III (4, 4P) • 

I, Disk (4, 4P) • 

4, 4P, Disk • 

cc, basic ,ci; ::„_;;;: __ ;:, ~. 

CC, Ext BASIC « : \ ;"- : ." :> . '- 

CC, Disk » -..-.:: _y. k ~:\ - , 

MC-10 '~~"~~ 7C ™ r -I-~r ' : ' : ' ■>■ 

Model 100 
Model 100, Disk 

FORMAT 

Edit Mode: Space-Bar press 
Edit Mode: nSpace-Bar press 

EXAMPLES 

1000 FOR 1=1 TO - (pressing 5 and space bar 
displays and spaces 5 additional characters on the 
line) 

DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. To display an 
additional character, press Space-Bar. To display n 
additional characters, enter a number of 1 through 
n and press Space-Bar. In the example above, 5 
was entered, followed by Space-Bar; this displayed 5 
additional characters on the line and positioned the 
cursor after the 5 additional characters. Space-Bar 
can be used to space along the line until the proper 
place is found to insert, delete, or modify characters 
by the other Edit Mode subcommands. 

RELATED COMMANDS 

Edit Mode Subcommands 




SYSTEM 

I, LVL I 

I, LVL II e 

I, Disk 9 

II, 12 • 

III, LVLI 

III, LVL III (4, 4P)» 
Ml, Disk (4, 4P) • 
4, 4P, Disk » 

CC, BASIC "_"._'."___ J'_*;". "^1,7. -■ : *- 

CC, Ext BASIC • •; .■.'-!• ;!-*; syj 

CC, Disk o ,.- .,••-—-. - v --: Jr^'.-C; 

MC-10 

Model 100 ' " -' " — — 

Model 100, Disk 

FORMAT 

Edit Mode: X press 
EXAMPLES 

1000 - (pressing X displays remainder of line 
and invokes the Insert mode) 
DESCRIPTION 

The Edit Mode is entered by the EDIT line# 
command. While in the Edit Mode, the current line 
is displayed in whole or in part. The cursor is 
positioned somewhere along the line. To display an 
additional character, press Space-Bar. To display the 
remainder of the line and position the cursor to the 
end of the line in the Insert mode, press X. In the 
example above, pressing X would have displayed 

1000 FOR 1=1 TO J-5 STEP 3- 

At this point the Insert mode would be in force and 
additional characters could be added to the end of 
the line. The X command is an "Extend Line" 
command and is used for that purpose. To terminate 
the Insert mode, press SHIFT up arrow together, or 
press ENTER. ENTER enters the current changes 
and returns to the command mode, while SHIFT up 
arrow terminates the Insert mode but keeps the Edit 
mode active. 

RELATED COMMANDS 

Edit Mode Subcommands 



SYSTEM 

LVL I » 
LVL II 

Disk • 

, 12 • 
I, LVL I 

I, LVL III (4, 4P) • 

I. Disk (4, 4P) « 

4, 4P, Disk * 
CC, BASIC 

CC, Ext BASIC » 

CC, Disk • 

MC-10 • 

Model 100 • 

Model 100, Disk « 




FORMAT 

linen END 

EXAMPLES 

1000 END stops execution and returns to the 
command mode 

DESCRIPTION 

END determines an end point of the BfiSIC 
program. When encountered by the BASIC 
interpreter, END causes the interpreter to stop 
program execution and return to the command 
mode. There may be any number of ENDs in the 
BRSIC program. It does not define the physical 
end of the program, but is only relevant during 
program execution. 

RELATED COMMANDS 

None 




THEN CLOSE I" 1 



iOTO 



SYSTEM 

, LVL I 
, LVL II 
, Disk * 

I, 12 * 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) « 

4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC 

CC, Disk <• 

MC-10 

Model 100 

Model 100, Disk 

FORMAT 

lineff. .. EOF (buW)... 

EXAMPLES 

1000 IF EOFfi; 
2000 

DESCRIPTION 

EOF is a Disk BRSIC function that indicates 
whether the "end-of-file" of a disk file has been 
reached. It is normally used during a disk read 
operation to test for the read of the last data from 
the file. Two types of reads might be done. In one 
type, the user knows exactly how many records are 
in a disk file and reads that exact number. In the 
second type, the user tests for EOF to determine 
when all of the data has been read. In the EOF 
case, a is returned when more data remains in 
the file, and a -1 is returned when all data has been 
read and an EOF condition exists. The EOF is used 
in this context as a "logical" function which 
specifies a true/false condition. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

linett ...EOF(7//e number).. 




EXAMPLES 

1000 IF EOF (3; 
GOTO 



THEN CLOSE 3: 



DESCRIPTION 

EOF is a BASIC function that indicates whether 
the "end-of-file" of a RAM, CAS, COM, or disk file 
has been reached. It is normally used during a read 
operation to test for the read of the last data from 
the file. Two types of reads are commonly done. In 
one type the user knows exactly how many records 
are in a file and reads that exact number. In the 
second type, the user tests for EOF to determine 
when all of the data has been read. In the EOF 
case a is returned when more data remains in the 
file, and a -1 is returned when all data has been 
read and an EOF condition exists. The EOF is used 
in this context as a "logical" function, which 
specifies a true/false condition. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 




FORMAT 

lineti ...expressionEQVexpression... 

EXAMPLES 

1000 C=fi EQV B 

DESCRIPTION 

EQV is a logical or bit manipulation operator that 
processes two operands in similar fashion to the 
more common AND or OR. EQV compares both 
operands (constants, variables, or expressions on a 
bit by bit basis. For each bit position, the result bit 
is a 1 when both bits are the same. IMP 0=1; 
IMP 1=0; 1 IMP 0=0; and 1 IMP 1=1. 
EQV is the inverse of the XOR function. The 
expressions are converted to 16-bit integers and 
then compared on a bit basis. If A is binary 
01010000 and B is 00111111, above, then C is 
10010000. 

RELATED COMMANDS 

XOR 



SYSTEM 

i 
I 
l 
l 
I 
I 
I 



LVLI 
LVL II 
Disk 
12 
I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

linen ERASE array I,arrray2,array3 

EXAMPLES 

1000 ERASE XX,A%,A$ erase three 
arrays 

DESCRIPTION 

ERASE is used to "de-allocate" one or more arrays. 
When ERASE is executed, the specified arrays are 
removed from RAM space, and the area allocated 
for the arrays is released to the free memory area. 
ERASE is the opposite of DIM. Arrays deleted in 
an ERASE may be redimensioned. ERASE removes 
the entire array and cannot be used to remove one 
or a few entries of the array. 

RELATED COMMANDS 

DIM 



SYSTEM 




I, LVL I 

I, LVL II « 

I, Disk » 

II, 12 9 

III, LVL I 

III, LVL III (4. 4P) • 
III, Disk (4, 4P) • 
4, 4P, Disk » 

CC, BASIC 

CC, Ext BASIC ~ '" " " •" \ 

CC, Disk -"- -- -."."- ; '" " ..,;-" Vr,./. 

Mc-io - - —'--/-".:'.' -'- ',':.;• •.,.... 

Model 100 • 

Model 100, Disk • 

FORMAT 

//"ne#...ERl 

EXAMPLES 

1000 IF ERL=2000 THEN STOP stop if invalid 
read in line 2000 

DESCRIPTION 

ERL is a special error-processing function which 
returns the line number in which an error occurred. 
The ERL is normally used within an error- 
processing routine defined by the line number in an 
ON ERROR GOTO command. When any error 
occurs and the user error-handling mode is in force, 
the error-processing routine takes suitable actions 
for the error, such as displaying the type of error, 
line number, and corrective action. The ERL allows 
the error-processing routine to determine the line 
number and therefore further information about the 
manner of error and action to take. If a program 
error has occurred since power up, ERL returns the 
line number of the last error. If an error occurred in 
the command mode (such as entering LLLIST), 
65535 is returned as the ERL argument to signify 
that no line number was involved. 

RELATED COMMANDS 

ERR, ERROR, ON ERROR GOTO, RESUME 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) - 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk < 




FORMAT 

//ne#...ERR... 

EXAMPLES 

1000 IF ERR/2+l=4 THEN STOP stop if out 
of data 

DESCRIPTION 

ERR is a special error-processing function which 
returns the error code for the error that just 
occurred. ERR is normally used within an error- 
processing routine defined by the line number in an 
ON ERROR GOTO command. When any error 
occurs and the user error-handling mode is in force, 
the error-processing routine takes suitable actions 
for the error, such as displaying the type of error, 
line number, and corrective action. The ERR allows 
the error-processing routine to determine the type of 
error and therefore define the manner of error and 
action to take. The expression ERR/2+1 is used to 
find the true error code for the Models I and III. 

RELATED COMMANDS 

ERL, ERROR, ON ERROR GOTO, RESUME 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

//7?e# ...ERRS... 

EXAMPLES 

1000 PRINT "ERROR: 



';ERR$ 



DESCRIPTION 

ERRS returns a text string containing the number 
and description of the TRSDOS error related to the 
latest BASIC disk error. BASIC normally displays 
a "DISK I/O" error indication. ERRS is a way of 
further defining the error in TRSDOS. ERRS would 
normally be used in BASIC error-handling routines 
to notify the user of errors and to determine some 
corrective action. If no TRSDOS error occurred, 
ERRS returns a null string. 

RELATED COMMANDS 

ON ERROR GOTO 



SYSTEM 

I, LVL I 

I, LVL II » 

I, Disk o 

II, 12 

III, LVL I 

III, LVL III (4, 4P)* 

III, Disk (4, 4P) * 

4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 • 

Model 100, Disk » 

FORMAT 

//'ne# ERROR code 

EXAMPLES 

1000 ERROR 4 




simulate out of data error 



DESCRIPTION 

ERROR is used to simulate an error condition. 
ERROR is primarily used to test a user error- 
processing routine. The error-processing routine is 
established by an ON ERROR GOTO command 
with appropriate error handing code. 

RELATED COMMANDS 

ON ERROR GOTO 



SYSTEM 



LVL I 
LVL II 
Disk 
12 

LVL I 

LVL III (4, 4P) 
Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

tXLC 

EXEC address 

EXAMPLES 

EXEC execute last loaded machine-language 
program 

DESCRIPTION 

EXEC causes a transfer to the last CLOflDM 
address or to the specified address value. EXEC is 
used primarily after a CLOflDM command to 
transfer control to the machine-language file, 
assumed to be a major program (one not generally 
interfacing to BASIC via the U5R command). 
EXEC may also be used in the "EXEC address" 
format to transfer control to any machine-language 
code at any time while in the command mode. The 
address parameter specifies the starting address for 
execution. 

RELATED COMMANDS 

CLOflDM 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk ■ 



FORMAT 

line#...E.XP(expression)... 

EXAMPLES 

1000 R=EXP(X) 

DESCRIPTION 

EXP is the inverse of the LOG function. It returns 
the natural exponential of X, or e (2.718...) to the X 
power. Natural logarithms and exponentials are used 
in a variety of mathematical and scientific 
applications. 

RELATED COMMANDS 

LOG 




SYSTEM 

LVL I 

LVL li 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

lineti FIELD buW,n AS namel,n AS name2,...,n AS 
namen 

EXAMPLES 

1000 FIELD 1,20 05 LNRME$,20 OS 
FNRME$,40 RS RDDR$ 

DESCRIPTION 

FIELD is used to define fields of specified length 
within a random-file buffer. Fields are subdivisions 
of a record. Each field has a name specified in the 
field statement. The field name may be used in 
LSET, RSET or other commands to easily store or 
retrieve character data from the record without 
having to specify the relative location of the data in 
numeric form. It would be much more convenient to 
reference "FNRME" for "first name" than the 20th 
through 39th characters in a record, for example. 
The buf# parameter defines the buffer number to be 
used when referencing data. The buffer number is 
associated with a file by the OPEN command. The n 
parameters define the length of the field in 
characters. The name parameters define a field 
string variable name. (DUMMYS can be used to 
"space over" characters.) The total number of 
characters used for the fields must equal the record 
length defined in the OPEN. 
RELATED COMMANDS 

LSET, RSET 



* - _ <? ^S^&ii3$?&&^>je -ft 




SYSTEM 

LVL I 

LVL II 

Disk 

12 

, LVL I 
LVL III (4, 4P) 
Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

FILES number of bufs,buffer size 
linett FILES number of bufs,buffer size 



EXAMPLES 

FILES 3,256 



reserve 3 bufs of 256 bytes 



DESCRIPTION 

FILES specifies how many disk buffers to reserve 
in memory and how large the buffers should be. The 
buffer size parameter is optional; if not used, a 
buffer size of 256 bytes is used. Disk BASIC uses 
buffers to assemble records on output to disk and to 
read in sectors of the disk on input. Sectors are 256 
bytes long, and this is the normal length for RAM 
buffers. If FILES is never specified, two buffers of 
256 bytes are assumed. 

RELATED COMMANDS 
None 



SYSTEM 







feSEJBB 






I, LVL I 

LVL II 

Disk 
12 

, LVL I 

, LVL III (4, 4P) 

, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

FILES 
linett FILES 

EXAMPLES 

FILES 



DESCRIPTION 

FILES is normally used in the command mode to 
display all files currently stored in RAM on the led 
screen. You may continue in BASIC at any time by 
entering a new BASIC command. 

RELATED COMMANDS 

None 






SYSTEM 



I, LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//ne#... F I X(expression).. 




EXAMPLES 

1000 REM FIND INTEGER PORTION OF X 

1010 IN=FIX(X) put integer portion in IN 

DESCRIPTION 

FIX finds the integer portion of a constant, 
variable, or expression. Unlike INT, it finds the true 
integer portion of a negative argument. The integer 
portions of +1.12, +100.45, 0, -5.567, and -999.999 
are 1, 100, 0, -5, and -999, respectively. The 
argument must be within parentheses. The argument 
does not have to be an integer value (-32768 to 
+32767). 

RELATED COMMANDS 

INT 




SYSTEM 

I, LVL I e 

I, LVL II 

I. Disk » 

II. 12 

III. LVL I » 
III. LVL III (4. 4P) • 
III, Disk (4, 4P) » 
4, 4P, Disk » 
CC, BASIC o 
CC, Ext BASIC » 
CC, Disk 
MC-10 

Model 100 • / : — jj^r-^- ip,i- ;Vr-J 

Model 100, Disk » I" — ^^-^ - ~ ±~ r*-^ .< 

FORMAT 

linett FOR variable=expression TO expression 

STEP expression 

EXAMPLES 

1000 FOR 1=0 TO 100 loop 101 times 

2000 FOR 1=7 TO 100 STEP 2 loop 47 times 

3000 FOR 1=101 TO STEP -2 loop 51 

times 
DESCRIPTION 

The FOR. . .TO. . .STEP commands, together 
with NEXT, set up and execute a program loop. The 
"variable" is executed from the starting value given 
in the expression 1 TO an ending value given in 
expression 2. The two start and end values may be 
constants, variables, or expressions. If no STEP size 
is given, the variable is incremented by one each 
time the loop is repeated, until the variable equals 
the end value. If a STEP size is given, the variable 
increments by the STEP size each time through the 
loop. The start and end values may be positive or 
negative. If the start is less than the end value, a 
STEP of a negative value is mandatory. A NEXT 
command later in the program defines the end of 
the loop and transfers control back to the 
FOR. . .TO. . .STEP statement for the next 
iteration of the loop. Any number of loops may be 
"nested'.' 

RELATED COMMANDS NEXT 



SYSTEM 



I, LVL I 

I, LVL II « 

I, Disk « 

II, 12 * 

III, LVL I 

III, LVL III (4, 4P)* 

III, Disk (4, 4P) 9 

4, 4P, Disk <• 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 » 

Model 100, Disk « 

FORMAT 

FRE(string) 
linett...FRE(string).. 

EXAMPLES 




n$' 



1000 PRINT FREl 

DESCRIPTION 

FRE returns the amount of free string storage space 
available in bytes. In finding the amount of string 
storage, the BASIC interpreter "cleans up" the 
string storage area near the top of RAM to create 
the maximum free string space. The string storage 
area size was first specified in a CLEAR statement. 
If no CLEAR statement was encountered, 50 bytes 
of string storage space is automatically saved. The 
"string" parameter within parentheses is a 
"dummy" argument; the string variable specified 
has no significance. FRE is usually entered from 
the command mode, although it can be used within 
a BASIC program as a check on free string space. 
If the argument in FRE is numeric, FRE returns 
the total amount of free memory. 
Models 4 and 100: FRE(number) returns the 
amount of free memory space. 
RELATED COMMANDS 

CLEAR 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC40 

Model 100 

Model 100, Disk 




FORMAT 

//ne# ...FREEfdr/Ve#j... 

EXAMPLES 

PRINT FREE(l) 

DESCRIPTION 

FREE is a Color Computer Disk BASIC command 
that returns the number of free granules on the 
diskette for the specified disk drive. A granule is the 
minimum unit of disk drive space allocated by the 
BASIC "file manage" handler and is equal to 5 
sectors, or 2304 bytes. FREE is used either in the 
command mode or embedded in a program to find 
the space remaining on a diskette for user programs 
or data. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

lineti GET buftt 
lineti GET buf#,rec# 

EXAMPLES 

1000 GET 3 , 100 get 100ft record 

DESCRIPTION 

GET is used to read a random-access file record 
from disk. A random-access file allows records to be 
read or written on a random basis (not in 
sequence). The GET permits either the next record 
in sequence or any record number of the file to be 
read into the buffer associated with the file. Prior to 
the GET, an OPEN with the "R" option must have 
been executed. The OPEN defines the filename and 
buffer associated with the file. The 
"GET buf#" form of GET reads in the current 
record, the number whose number is one higher 
than the last access. If no record has been read, 
this is the first record of the file. The second form 
of GET reads in the specified record defined by 
"rec#" 

RELATED COMMANDS 

PUT 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC ,-. - "•*"--_- : -: 

cc, Ext basic • . ~" " ~, ;~7> ; r*- '."," 

CC, Disk • ; ' ."C ' ', ' ,';_ 

MC-10 

Model 100 - 

Model 100, Disk 

FORMAT 

linett GEJ(xl,yl)-(x2,y2),array name,g 

EXAMPLES 

1000 GET ( , ) - ( 50 , 50 ) , fifi , G save 
area in array AA 
DESCRIPTION 

The GET command is used in conjunction with the 
PUT command. GET stores any rectangular area on 
a graphics screen in a two-dimensional array. The 
PUT later retrieves the graphics data from the array 
and displays it in any other area of the graphics 
screen. GET/PUT can be used to save portions of 
a graphics screen or to create animation effects. The 
xl.yl coordinates define one corner of the rectangle 
to be stored in the array; The x2,y2 define the 
opposing corner. The xl,x2 and yl,y2 values are in 
"high-resolution" graphics coordinates of 0-255 and 
0-191, respectively. The "array name" is the name 
of a two-dimensional array previously defined by a 
DIM statement. In general, the array size must be 
equal to the dimensions of the graphics area to be 
stored, although certain space-saving tricks may be 
used. The g option is "G"; if used, full graphic detail 
is saved in the array. 
RELATED COMMANDS 
PUT 




SYSTEM 

, LVL I ° 

, LVL II « 

, Disk • 

I. 12 * 

II, LVL I <• 
II, LVL III (4. 4P) • 
II, Disk (4, 4P) » 

4, 4P, Disk » 

CC, BASIC « 

CC, Ext BASIC • - " " '■*■ "_ _l 

CC, Disk • / , '," ;-i ;; " . 

MC-10 • ..-. :•-'; V-'-., v ',• .•:„'. 

Model 100 • • -V.' -.„ ~ r - ';•'>. ,v-_.\ 

Model 100, Disk a --—•-- 

FORMAT 

linen GOSUB //ne# 
EXAMPLES 

1000 REM DO SEARCH SUBROUTINE' 

1010 GOSUB 12000 

1020 REM RETURN HERE AFTER 

SUBROUTINE 

DESCRIPTION 

GOSUB is used to "call" a subroutine. A subroutine 
is any set of BASIC statements that is used 
repeatedly. Making the statements a subroutine in 
one spot rather than repeating the code when 
required saves RAM space. The GOSUB causes the 
BASIC interpreter to branch to the line number 
specified after the GOSUB. Unlike the GOTO, the 
GOSUB action saves the return point after the 
GOSUB. After the subroutine has been executed, 
the last statement of the subroutine, a RETURN, 
returns control to the statement after the GOSUB. 
In the example above, the subroutine at line 
12000 would be executed; it could consist of from 
one to many statements. The last statement, 
however, is a RETURN, which causes a return to 
line number 1020. Subroutines may be "nested" in 
many levels. One subroutine may call another by a 
GOSUB, which may call yet another, etc. 
RELATED COMMANDS 

ON... GOSUB, RETURN 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

line^ GOTO linen 
GOTO linen 

EXAMPLES 

1000 GOTO 2000 transfers control to line # 

2000 

GOTO 2000 continues at line 2000 

DESCRIPTION 

GOTO is used in BASIC programs to transfer 
control from one statement to another. It is the 
normal way of "unconditionally branching" in the 
program. Any number of GOTOs may be used in a 
program. When a GOTO is executed, no record of 
where the GOTO occurred is kept by the BASIC 
interpreter, unlike a GOSUB. When a GOTO is used 
in the command mode, the BASIC program 
continues from the specified line number with all 
variables and BASIC parameters intact. The GOTO 
in this use may be used in lieu of a CONT 
(continue) to restart the program at any point. 

RELATED COMMANDS 

CONT, GOSUB 



SYSTEM 

LVL I 

LVLII 

Disk 

12 

, LVL I 

, LVL III (4, 4P) 

, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC40 
Model 100 
Model 100, Disk 




FORMAT 

linett. . . HE X S(expression). . . 

EXAMPLES 

1000 PRINT HEX$f A] 



find hex value of A 



DESCRIPTION 

HEX$ is a special function that will convert a 
constant, variable, or expression to a string that 
represents the hexadecimal value of the argument 
HEX$(1000), for example, will be converted to 
the string "3E8". Hexadecimal notation is used 
primarily for machine-language operations in 
specifying addresses, instruction codes, and data 
values. 

RELATED COMMANDS 

&H 




SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk ■ 



FORMAT 

...HI MEM 

EXAMPLES 

PRINT HI MEM print top of memory address 

DESCRIPTION 

The HIMEM function returns the address of the top 
of memory. This value is normally equal to the value 
of MRXRHM, the maximum memory address for 
your system — its dependent upon the amount of 
RAM memory you have in your system. If CLEAR is 
used to protect a portion of high memory, then 
HIMEM is set to the CLEAR value. HIMEM is the 
highest memory location which BASIC and other 
programs may use. 

RELATED COMMANDS 

CLEAR, MAXRAM 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P)' 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk ' 



FORMAT 

line# IF true/ false expression THEN action 

EXAMPLES 

1000 IF A<25 THEN fi=25 test A 
1010 IF [R=3 OR B=6) THEN GOTO 4000 
DESCRIPTION 

The IF. . .THEN command is used to test a 
true/false condition and to take some action if the 
result is true. If the result is not true, the next 
statement in sequence is executed. The true/false 
expression may contain any relational operators, 
such as test for equality (A=B), sense (A<B), string 
comparisons (A$<B$), and others. Constants, 
variables, or expressions may be used in the 
true/false expression in any mixture. The action to 
be taken if the true/false expression is true may be 
any one statement action, such as "THEN PRINT 
ft", or "THEN fi=(3.66*I-2)". The THEN is 
not necessary in the case of a transfer to a line# 
such as "THEN GOTO 3000'.' If multiple 
statements are on a single line after the THEN, all 
statements after the THEN will be executed if the 
true/false expression is true. The line 
"1000 IF fl<2 THEN fl=l:B=23: PRINT C" 
will result in A set equal to 1, B set equal to 23 and 
C being printed if A is less than 2. 
RELATED COMMANDS 
IF... THEN... ELSE 




I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III. Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 



FORMAT 

linett IF true/false expression THEN action ELSE 

action 

EXAMPLES 

1000 IF fl<2 THEN fi=fl+4 ELSE FfA+5 
1010 IF B=(I+37) THEN C=5 ELSE IF 
B=(I+38) THEN 0=6 
DESCRIPTION 

The IF... THEN . . . ELSE command is used to 
test a true/false expression and to take the THEN 
action if the statement is true and the ELSE action 
if the statement is false. The true/false expression 
may use any relational operators as in "IF fl=2" 
"IF fi<2" "IF fl$<B$" If the true/false 
expression is true, the THEN action is taken and 
the ELSE action disregarded. The THEN action 
may be a single statement action of any type. If the 
true/false expression is false, the ELSE action is 
taken and the THEN action disregarded. The THEN 
action may be any single statement action. A line 
number may be used without a GOTO following the 
THEN or ELSE. "Nested" IF. . .THEN. . .ELSE 
commands may be used as shown in the example 
above. If multiple statements follow the ELSE, then 
all actions up to the end of the line are taken in the 
false condition. 

RELATED COMMANDS 

IF... THEN 




SYSTEM 

LVLI 

LVLII 

Disk 

, 12 

I, LVL I 

I. LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk « 



FORMAT 

linett . . . expression I M Pexpression.. . 

EXAMPLES 

1000 C=fi IMP B 

DESCRIPTION 

IMP is a logical or bit manipulation operator that 
processes two operands in similar fashion to the 
more common AND or OR. IMP compares both 
operands on a bit by bit basis. For each bit position, 
the result bit is a 1 unless the bit of the first 
operand is a 1 and the bit of the second operand is 
a 0. IMP 0=1; IMP 1=1; 1 IMP 0=0; 
and 1 IMP 1=1. The expressions are converted to 
16-bit integers and then compared on a bit basis. If 
A is binary 01010000 and B is 00111111, above, 
then C is 10111111. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVLI 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//ne#... INKEYS... 

EXAMPLES 

1000 IF INKEYSO" " THEN GOTO 
2000 go if key press 
DESCRIPTION 

INKEYS is a special string function that allows you 
to read the keyboard at "real-time" rates. If no key 
is being pressed on the keyboard, INKEYS is set 
equal to a "null" string of zero length, defined by 
" '.' If a key is being pressed, INKEYS is set equal 
to the current key press on the keyboard for a brief 
period. If the key is not released, INKEYS is 
shortly set equal to a "null" string. If one key is 
being depressed and a second is pushed, INKEY$ 
is set equal to the second key (for a brief period). 
Successive pushes of the same key result in short 
bursts where INKEYS is set equal to the key 
character interspersed with longer periods where 
INKEY$=" '.' INKEYS can be used in a loop to 
test for key presses at real-time rates. The following 
code builds up a string of keypushes: 
1000 B$=INKEY$ 

1010 IF 6'$=' ' ' ' THEN GOTO 1000 ELSE 
fi$=fi$+B$: GOTO 1000 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk a 

II, 12 

III, LVL I 

III, LVL III (4, 4P)® 
III, Disk (4, 4P) ® 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 « | 

Model 100, Disk • l 

FORMAT 

/;ne# IHP(port) 

EXAMPLES 

1000 A=INP[255" 

DESCRIPTION 

IMP inputs a one-byte value from a system 
input/output port. Systems using the 2-80 and 8080 
microprocessors use input/output ports for certain 
system devices such as cassette and RS-232-C 
operations. The INP is a BASIC command that will 
enable the user to directly read these I/O ports. The 
port parameter is an address value of through 
255 that defines the port address. It must be within 
parentheses. INP returns a one-byte (8-bit) value 
representing input data on the specified port 
address. 

RELATED COMMANDS 

OUT 



read cassette on Model l/lll 
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SYSTEM 

I, LVL I m 

I. LVL II » 

I, Disk » 

II, 12 * 

III, LVL I o 
Ml, LVL III (4. 4P) • 
III, Disk (4, 4P) • 
4, 4P, Disk «• 
CC, BASIC « 
CC, Ext BASIC • 
CC, Disk » 
MC-10 o 
Model 100 » 
Model 100, Disk • 

FORMAT 

//ne# INPUT item list 

EXAMPLES 

1000 INPUT A$,EN,AG input 
name, number, age 

DESCRIPTION 

INPUT is used to enter data from the keyboard. 
Data is entered as a list of items. For each item in 
the data list, INPUT accepts a numeric or string 
variable. Entries may be entered one at a time from 
the keyboard or all entries may be entered with 
each individual item separated by commas. The type 
of entry must match the data item type - numeric 
items cannot include text. If an invalid item type is 
entered, a "REDO" message is output. BASIC 
prompts the user by a "?" when INPUT is 
expected. If more than one item is in the INPUT 
list and not all entries have been entered when the 
ENTER key is pushed, BASIC indicates that more 
items are expected by "??'.' Entering more items 
than there are in the list causes an "7EXTRA 
IGNORED" message. 

RELATED COMMANDS 

None 




input 



SYSTEM 

I, LVL I • 

I, LVL II » 

I, Disk • 

II, 12 • 

III, LVL I » 
III, LVL III (4. 4P) • 
III, Disk (4, 4P) • 
4, 4P, Disk » 
CC, BASIC « 
CC, Ext BASIC • 
CC, Disk « 
MC-10 • 
Model 100 * 
Model 100, Disk • 

FORMAT 

linett INPUT "text";item list 
EXAMPLES 

1000 INPUT "ENTER 
NRME,8,RGE";R$,EN,RG 
name, number, age 
DESCRIPTION 

INPUT...; is identical to the normal INPUT 
statement except that a message is displayed before 
the INPUT. The text of the message is enclosed by 
double quotes and separated from the item list by a 
semicolon. INPUT is used to enter data from the 
keyboard. Data is entered as a list of items. For 
each item in the data list, INPUT accepts a 
numeric or string variable. Entries may be entered 
one at a time from the keyboard or all entries may 
be entered with each individual item separated by 
commas. The type of entry must match the data 
item type - numeric items cannot include text. If an 
invalid item type is entered, a "REDO" message is 
output. BRSIC prompts the user when INPUT is 
executed by a "?'.' If more than one item is in the 
INPUT list and not all entries have been entered 
when the ENTER key is pushed, BRSIC indicates 
that more items are expected by "??'.' Entering more 
items than there are in the list causes an "7EXTRR 
IGNORED" message. 
RELATED COMMANDS None 



SYSTEM 




, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC ^^^s^zmms&zz^tz^ 

CC, Ext BASIC : JW^^Sf^^fW^^ 

cc, Disk /; ; .'-V'~->:. v j!' ;-\"- i, e.-, 

mc-io -si - ---ii: --. : -;->r; ? -• - yr \ 

Model 100 • !-- — V . • - . , ; 

Model 100, Disk • l i 

FORMAT 

linett INPUTtt file number .item list 

EXAMPLES 

1000 INPUTtt 3,R,B,C$ input from COM 

DESCRIPTION 

INPUTtt is used to input a list of items from a 
RAM, CAS, COM, MDM, or disk file. It is similar to 
the keyboard INPUT statement except that the 
data items are read from the device file. Normally 
the items have been output to the device file with a 
PRINT8 statement. The item list must follow the 
same sequence as the items in the device file; if two 
numeric items are followed by one string item, for 
example, then the three variables read must be 
numeric, numeric, string. Data in device files is 
written as a succession of ASCII characters. The 
INPUTtt reads in the characters, detects the 
terminators between data items, and converts each 
item to the proper type for the item list. The file 
number in the INPUTtt statement must match the 
file number used in the OPEN statement for the 
device file. 

RELATED COMMANDS 

OPEN, PRINT8 




SYSTEM 

, LVLI 
, LVL II 
, Disk • 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) «> 

4, 4P, Disk ® 

CC, BASIC 

CC, Ext BASIC ■ , 

CC, Disk ® 

MC-10 

Model 100 

Model 100, Disk 

FORMAT 

linett INPUTB bufUJtem list 

EXAMPLES 

10001 NPUTtt 3 , R , B , C$ input from disk file 

DESCRIPTION 

INPUTtt is used to input a list of items from a 
sequential file on disk. It is similar to the keyboard 
INPUT statement except that the data items are 
read from a disk file. The disk file must have been 
previously OPENed; the OPEN associates the buf# 
parameter with a sequential disk file. Normally the 
data items have been output to the disk file with a 
PRINTS statement. The item list must follow the 
same sequence as the items in the disk file; if two 
numeric items are followed by one string item, then 
the three variables read must be numeric, numeric, 
string. Data in sequential files is written onto disk as 
a succession of ASCII characters. Even numeric data 
is output as a string of characters. The INPUTtt 
reads in the character data, detects the terminators 
between data items, and converts each item to the 
proper type for the item list. Blanks and the ENTER 
character generally serve as terminators between 
numeric data items, while commas separate string 
variables. 
RELATED COMMANDS 

PRINTtt 




input from cassette 



SYSTEM 

I, LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVLI 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

line# INPUTtt,/tem list 

EXAMPLES 

1000 I NPUTtt, fi,B,C$ 

DESCRIPTION 

INPUTtt is used to input a list of items from a 
cassette file. It is similar to the keyboard INPUT 
statement except that the data items are read from 
a cassette file. Normally the data items have been 
output to the cassette file with a PRINTtt 
statement. The item list must follow the same 
sequence as the items in the cassette file; if two 
numeric items are followed by one string item, then 
the three variables read must be numeric, numeric, 
string. Data in cassette files is written as a 
succession of ASCII characters. Even numeric data 
is output as a string of characters. The INPUTtt 
reads in the character data, detects the terminators 
between data items, and converts each item to the 
proper type for the item list. Blanks and the ENTER 
character generally serve as terminators between 
numeric data items, while commas separate string 
variables. 

RELATED COMMANDS 

PRINTtt 




SYSTEM 

I, LVL I 

I, LVL II ° 

I, Disk * 

II, 12 

III, LVL I 

III, LVL III (4. 4P)» 
III, Disk (4, 4P) « 
4, 4P, Disk 
CC, BASIC • 

CC, Ext BASIC • .. :~-"7^^-or;^: ;,' , 

CC, Disk » LZJ^SfVJ~ r %J:~r. t -'~^ t 

MC-10 ,C^--^"-^>— - 'He : ri 

Model 100 -- 

Model 100, Disk 

FORMAT 

linett 1NPU1U -l,item list 
EXAMPLES 

1000 INPUTtt-l,fl,B,C$ input 
from cassette 
DESCRIPTION 

INPUT8-1 is used to'input a list of items from a 
cassette file. It is similar to the keyboard INPUT 
statement except that the data items are read from 
a cassette file. Normally the data items have been 
output to the cassette file with a PRlNTtt-l 
statement. The item list must follow the same 
sequence as the items in the cassette file; if two 
numeric items are followed by one string item, then 
the three variables read must be numeric, numeric, 
string. Data in cassette files is written as a 
succession of ASCII characters. Even numeric data 
is output as a string of characters. The INPUT8-1 
reads in the character data, detects the terminators 
between data items, and converts each item to the 
proper type for the item list. Blanks and the ENTER 
character generally serve as terminators between 
numeric data items, while commas separate string 
variables. 
RELATED COMMANDS 

PRINT8-1 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk • 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 

III, Disk (4, 4P) 
4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC :~-c - — ^- 

CC, Disk 

mc-io ' : i; .::; ■ -. "- 

Model 100 
Model 100, Disk 

FORMAT 

linett INPUTtt -2,item list 
EXAMPLES 

1000 I NPUT8 - 2 , ft , B , C$ input from cassette 
DESCRIPTION 

INPUTS -2 is used to input a list of items from a 
cassette file. It is identical to INPUT8-1 except 
that the cassette file is on the second cassette drive. 
It is similar to the keyboard INPUT statement 
except that the data items are read from a cassette 
file. Normally the data items have been output to 
the cassette file with a PRINT8- statement. The 
item list must follow the same sequence as the 
items in the cassette file; if two numeric items are 
followed by one string item, then the three variables 
read must be numeric, numeric, string. Data in 
cassette files is written as a succession of ASCII 
characters. Even numeric data is output as a string 
of characters. The INPUT8-1 reads in the 
character data, detects the terminators between 
data items, and converts each item to the proper 
type for the item list. Blanks and the ENTER 
character generally serve as terminators between 
numeric data items, while commas separate string 
variables. 

RELATED COMMANDS 

PRINTB-l,PRINT8-2 



E^k 




SYSTEM 

I, LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 • 

Model 100, Disk » 

FORMAT 

lineti INPUTS (length.file number) 
EXAMPLES 

1000 INPUTS f20,3] read 20 characters 
DESCRIPTION 

INPUTS is used to read a specified number of 
characters from a RAM, CAS, COM, MDM, or disk 
file. It is similar to the keyboard LINE INPUT 
command except that the input string is terminated 
by a number of characters rather than the ENTER 
key. The length parameter is a value from 1 through 
255. The file number is the file number associated 
with the device file and established in the OPEN 
command for that device file. When INPUTS is 
executed, BASIC will wait until the specified 
number of characters have been read from the 
device file and will then return all characters as a 
string. All characters will be returned, including 
those that would normally be delimiters, such as 
commas. 1000 A$=INPUT$ (20,3 j, for 
example, would specify that AS would be set equal 
to the next 20 characters read from the device file 
associated with file number 3 and that the next line 
would not be executed until those 20 characters 
were input. 

RELATED COMMANDS 

LINE INPUT, OPEN 




BBS 



input 10 characters 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk <• 

CC, BASIC L---~-' 

CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 L " 

Model 100, Disk 

FORMAT 

linett ...mPUT $(length,buW).. 
EXAMPLES 

1000 A$= INPUTS (10,3 
from disk 

DESCRIPTION 

INPUTS is a function that specifies the number of 
characters that will be read from a sequential disk 
file. It is somewhat similar to LINE INPUTtt 
except that the input string is terminated by a 
number of characters rather than the ENTER key. 
The length parameter is a value from 1 through 
255. The buf# is the number of the sequential file 
input buffer specified in the OPEN statement 
associated with the file name. When INPUTS is 
executed, BASIC will wait until the specified 
number of characters are read from the disk file 
and then return all characters as a string. All 
characters read will be returned, including those 
that would normally be delimiters, such as commas. 
1000 A$= INPUTS (10,3), for example, would 
specify that A$ would be set equal to the next 10 
characters input from the disk file associated with 
buffer 3 and that the next line would not be 
executed until those 10 characters were input. 

RELATED COMMANDS 

LINE INPUTtt 




input from cassette 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk ® 

CC, BASIC -E= 

CC, Ext BASIC .f%~ 

CC, Disk SW, 

Mc-io r^ 

Model 100 ® / t 

Model 100, Disk « (^ 

FORMAT 

lineH INPUTtt./tem list 
EXAMPLES 

1000 INPUTS,fi,B,C$ 

DESCRIPTION 

INPUTS is used to input a list of items from a 
cassette file. It is similar to the keyboard INPUT 
statement except that the data items are read from 
a cassette file. Normally the data items have been 
output to the cassette file with a PRINTS 
statement. The item list must follow the same 
sequence as the items in the cassette file; if two 
numeric items are followed by one string item, then 
the three variables read must be numeric, numeric, 
string. Data in cassette files is written as a 
succession of ASCII characters. Even numeric data 
is output as a string of characters. The INPUTS 
reads in the character data, detects the terminators 
between data items, and converts each item to the 
proper type for the item list. Blanks and the ENTER 
character generally serve as terminators between 
numeric data items, while commas separate string 
variables. 

RELATED COMMANDS 

PRINTS 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 



FORMAT 

linen... WSTR(stringl,string2) 
line#... I H5JR(position,stringl,string2) 
EXAMPLES 

1000 fi=INSTR(fi$, ' 'ISS" ) look for "ISS" 
in A$ 

DESCRIPTION 

INSTR is a function that searches for a substring 
within a larger string. The stringl and string2 
parameters are string literals or variables. (String 
literals will be enclosed in quotes; string variables 
will have the "$" suffix or DEFSTR definition.) If 
the first format is used, INSTR will search for 
string2 in stringl. If string2 is found within stringl, 
the starting position of the first occurrence of 
string2 will be returned. If string2 is not found 
within stringl, will be returned. Positions of 
strings are numbered from 1 through the length of 
the string in characters. If the second format is 
used, the "position" parameter is a constant, 
variable, or expression that specifies the starting 
position for the search. In the example above, if 
A$="MISSISSIPPI" INSTR would set A to 2. The 
second occurrence of ISS would have to be found 
by specifying a position greater than 2. 
RELATED COMMANDS 
None 




, LVL I e 

, LVL II • 

, Disk • 

I, 12 * 

II, LVL I • 
II, LVL III (4, 4P)« 
II, Disk (4. 4P) a 

4, 4P, Disk » 

CC, BASIC » 

cc, Ext basic • /, v~: ^ -" .v.£i ';;."--m • 

CC, Disk » <r~. J;. : -r rV, :v ;-'--:/ /-~-W* 

MC-10 ® -- bJE-~1- " ' I " 'I<~ . 

Model 100 • 

Model 100, Disk • 

FORMAT 

lineti... I HT(expression)... 
EXAMPLES 

1000 REM POKE ADDRESS 

1010 POKE I+1,INTT' AD/256): POKE 

I, AD- (INT7 AD/256 1*256) 

DESCRIPTION 

INT returns the integer portion of a positive 
number and the next highest integer for a negative 
number. The argument may be a constant, variable, 
or expression and must be within parentheses. For 
arguments of +1.12, +999.45, 0, -1.11, and -234.56, 
INT returns +1, +999, 0, -2, and -235, respectively. 
INT is commonly used to find the two bytes of a 
16-bit address for POKES of addresses as in the 
example above, or for rounding operations, as in 

1000 FIND X ROUNDED TO 2 DEC PLACES 
1010 XR=INT '( X*100+ . 5 ) /100 

INT should be used to find the integer portion of 
positive numbers only; FIX should be used when 
both positive and negative numbers are involved. 
The argument in INT may be any size. 

RELATED COMMANDS 

FIX 
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SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk {4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk « 

FORMAT 

I PL "filename" 



EXAMPLES 

I PL " STARTS'. BA" 

DESCRIPTION 

IPL defines an "initial program load" file to be 
executed when the system is turned on. The 
program must be resident in RAM, the IPL with the 
filename executed, and the system turned off to 
initiate the IPL command. Every time the system 
power switch is turned on thereafter the designated 
program will start. IPL is used whenever most use 
of the system is for a single program; it's a 
convenience command that saves having to enter 
BASIC, load the program, and execute. 

RELATED COMMANDS 

None 




SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 



FORMAT 

//ne#...JOYSTK(nj... 

EXAMPLES 

1000 R= JOYSTK ( 3 ) get y coordinate of 

joystick 2 

DESCRIPTION^ 

JOYSTK is a special function that reads the 
joystick value. (The optional joysticks must be 
connected to the joystick plugs on the back of the 
Color Computer.) The n parameter defines the 
position parameter to be read. Each of the two 
joysticks will return an "x" coordinate and a "y" 
coordinate. Arguments of n=0 and n=l read the x 
and y coordinates from the left joystick, 
respectively. Arguments of 2 and 3 read the x and y 
coordinates from the right joystick. The value 
returned for any of the 4 positions is through 63. 
The up and left positions are and the down and 
right positions are 63. Intermediate positions are 
proportional, for example, the center position of a 
joystick is 32,32. JOYSTI<(0) must first be 
returned before JOYSTK (1) - JOYSTK ( 3) can 
be read. 

RELATED COMMANDS 
None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 

4, 4P, Disk _ 

CC, BASIC _.-> •"- __ ,,..- 

CC, Ext BASIC r ;^~~£™™™ir^^=-=^r 

CC, Disk •*.."- f- ,> .---.V 11 ' \_ , v.;- ■ 

MC-10 ;/-v..^:--\Y. -■'-■- ,u :• 'Y; 

Model 100 <• £ rri.-— •" :J """ ' '' ' \. ^ Vj 

Model 100, Disk <• 

FORMAT 

KEY N, string 
linett KEY H,string 
KEY LIST 
EXAMPLES 

KEY 4 , " ?DPY$ ' ' +CHR$ ( 13 j display day 
DESCRIPTION 

This KEY command allows the eight Function Keys 
to be set equal to a string of characters. Pressing a 
Function Key defined in this fashion will then be 
equal to entering the characters from the keyboard. 
In the example above, pressing Function Key 4 at 
any time after the Function Key definition will result 
in automatic generation of the string ' 'print 
DAYS' ' with a carriage return on the end — in 
this case the result will be a display of the string, 
followed by the date. All eight Function Keys can be 
defined in this manner and any key can be 
redefined at any time. N is a digit from 1 to 8 that 
defines the number of the Function Key. The string 
parameter may be any string expression of 1 to 15 
characters. To redefine the Function Keys to their 
original (default) values perform a CfiLL 
ZJ164,0,z.:!:j66: CALL 27795. Entering 
KEY LIST will display the current Function Key 
definitions on the screen. 

RELATED COMMANDS None 




ON 

OFF 

STOP 

ON enable Function Key 4 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

linen KEV'CNj 
//'ne# KEY(N') 
//'ne# KEYfNl 
EXAMPLES 
1000 KEY ( 4 ) 
interrupt 

DESCRIPTION 

The Function Key interrupts are used to interrupt a 
BR5IC program so that immediate action is taken 
when specific Function Keys are pressed. The ON 
KEY GOSUB command is first used to define a 
"processing 1 ' subroutine for the interrupt. Normally 
this subroutine would perform some processing 
function related to the Function Key and then return 
to the interrupted program. The KEY command 
allows the communications interrupt to be enabled 
or disabled by a KEY f N] ON or KEY (N) 
OFF— there are times when the interrupt should be 
acted upon and other times, when it should be 
ignored. The KEY (N) STOP "remembers" the 
interrupt but allows the program to ignore it until 
the next KEY ON, at which point the interrupt 
subroutine is immediately called. Each of the 
commands includes a KEY number from 1 to 8 to 
indicate which of the Function Keys is involved. 
RELATED COMMANDS 
ON KEY GOSUB 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) « 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk « 

MC-10 
Model 100 
Model 100, Disk 







W— 



FORMAT 

KILL "filename" 
lineti KILL "filename" 

EXAMPLES 

KILL "ACCOUNTS/BAS:l" kill accounts 
payable 

DESCRIPTION 

KILL deletes a file on disk. It is identical to the 
TRSDOS KILL command except that it may be 
performed inside BASIC in the command or 
execution modes. (Always CLOSE an open file 
before executing a KILL; if this is not done, the 
disk contents may be destroyed. ) The "filename" is 
a filespec for a BASIC program stored on disk; it 
conforms to the general requirements for filespecs - 
name, extension, password, and drive number. If no 
drive number is specified, KILL will delete the file 
from the first disk that contains the filename. (The 
order for the search is drive 0, 1, 2, and 3.) 

RELATED COMMANDS 

None 




SYSTEM 

, LVLI 
, LVL II 
, Disk 

I. 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 



FORMAT 

KILL "filename" 

EXAMPLES 

KILL "l:flCCTS.BR" 

DESCRIPTION 

KILL deletes a RAM or disk file. The "filename" is 
the name of the file to be killed, including extension 
(the portion after the period). If the extension is not 
included, the file will not be found in RAM or on 
disk and will not be deleted. If a disk file is to be 
deleted, the filename must include a drive number 
(0: or 1:) with colon before the name of the file. 

RELATED COMMANDS 

None 



SYSTEM 




I 



, if *rrr«*m^in2Mai 

~ -x:cGDc~n^!< --? i -tar \ 
~1 R~3f~yj,j«t,i 



m 



I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 

FORMAT 

LCOPY 

EXAMPLES 

LCOPY print screen 

DESCRIPTION 

LCOPY is used to "dump" the screen to the system 
printer. The printer must be in a "ready" condition. 
Any text data will be properly printed on the system 
printer in a 40 character per line by 8 line per 
screen format. Graphics data will be ignored and 
will not be printed. The LCOPY command is useful 
for obtaining a "hardcopy" listing of screen text 
data. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III. Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 



FORMAT 

linett...LEFT$(string,n)... 
EXAMPLES 

1000 fi$=LEFT$ f B$ , 4 ) get the first 4 

characters of B$ 

1010 C$=LEFT$ ( B$ , I j get the first I 

characters of B$ 

1020 D$=left$i;;b$, [ 1+2) ) get the first 1+2 

characters of B$ 

DESCRIPTION 

LEFTS finds the last n characters of a given string. 
The n parameter may be to 255. The "string" 
parameter is a previously defined string. If 
B$="HEROINE" for example, fi$=LEFT$f B$,4) 
will set A$="HER0" If n is greater than the length of 
the specified string, LEFT$ will return the entire 
string. fl$=LEFT$(B$,20j, for example, returns 
A$="HER0INE" The n argument may be a constant, 
variable, or expression. LEFTS may be used to 
process "substrings" where a large string is made 
up of a number of substrings concatenated 
together for ease of handling. 

RELATED COMMANDS 

MIDS, RIGHTS 



SYSTEM 

LVL I 

LVL II 

Disk 

12 

, LVL I 

, LVL III (4, 4P)' 

, Disk (4, 4P) - 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 




FORMAT 
line#...LEH(string) 

EXAMPLES 

1000 Lft=LEN(Fi$) 
1010 LB=LEN(B$) 



find # of characters in A$ 
find # of characters in B$ 



DESCRIPTION 

LEN finds the length in characters of a specified 
string. The length is the actual number of characters 
in the string, not counting string pointers. The 
"string" variable must be a valid string variable and 
may be a string expression such as A$+B$ or 
STRING$(5, "*" j. LEN produces a numeric 
variable of 6 to 255 which can be used in string 
processing. IF A$="THE ONLY ISM FOR ME IS 
COMPUTERISM'; then LEN(fl$ ]=34. 

RELATED COMMANDS 
None 



' 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk < 

MC-10 
Model 100 
Model 100, Disk « 




FORMAT 

lineti LET variable=expression 

EXAMPLES 

1000 LET fi=1.2345E-10: LET 
6=3.14153 

DESCRIPTION 

LET is used primarily for compatibility with older 
versions of BASIC. LET was used on older 
BASICS prior to setting a variable equal to a value 
or expression. On all TRS-80 BfiSICs, LET is 
optional and the variable may be set without the 
LET, as in 

1000 fl=1.2345E-10: 8=3.14159 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

Ml, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 f~ kz=z^ £ lMi=E! 

Model 100, Disk » 

FORMAT 

LFILES driveti 

EXAMPLES 

LFILES 1 

DESCRIPTION 

LFILES displays the names of all files on the 
specified drive#. Each file is displayed with the 
amount of disk space it uses, and a total available 
disk space is displayed at the end. The format of 
the listing of file names is coded for the type of file 
— the file name of six characters is followed by a 
seventh character which is coded as follows: 
"*" is a machine language file, "." is a BASIC 
program file, a blank is an ASCII BASIC program 
file. The next three characters are the file extension 
An LFILES listing of ACCTSF.BA, for example, 
shows a BASIC, non-ASCII file with extension .BA. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

IN, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 

cc, Ext basic » . ..: ._;__"' . ~: 

CC, Disk a ' l - ' "-■".: '^'A ',; 

MC-10 - ~ /;V->--^-- r . -".-'•■"■. 

Model 100 '-_-._--— • - \~> 

Model 100, Disk 

FORMAT 

linett Lmz(xl,yl)-(x2,y2),PSEJ 

linett L I HE(xl,ylHx2,y2), PRESET 

//'ne# L I HZ(xl,yl)-(x2,y2), PSET , B 

//'ne# L I NE(xl,yl)-(x2,y2), PRESET , B 

//ne# L I NE(xl,yl)-(x2,y2), PSET , BF 

//7?e# L I NE(xI ; yiKx2,y2j, PRESET , BF 

EXAMPLES 

1000 LINE (23,23)- 

(100, 100), PSET draw line 

1010 LINE (200,150)- 

( 220 , 170 ) , PRESET , BF erase filled-in box 

DESCRIPTION 

LINE is used to draw a line, box (rectangle), or 

filled-in box on the current graphics page. The xl.yl 

and x2,y2 parameters specify two points on the 

graphics screen. The values used for xl and x2 are 

through 255. The values used for yl and y2 are 

through 191. The x and y ranges are for the highest 

resolution graphics mode. The ...PSET form draws a 

line in the current foreground color between xl,yl 

and x2,y2; the ...PRESET form draws the line in 

the current background color. The ..,PSET,B and 

...PRESET, B forms draw the outline of a box in 

the current foreground and background color, 

respectively. The ..,PSET,BF and ..,PRESET,BF 

forms fill in the box with the current foreground or 

background color. 

RELATED COMMANDS None 




-(23y,63 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC 

CC, Disk / , 

MC-10 r 

Model 100 « : -i. 

Model 100, Disk ® 

FORMAT 

linett LIHE(xl,yl)-(x2,y2) 

linett L I HE(xl,yl)-(x2,y2),switch 

linett L I HE(xl,yl)-(x2,y2),switch,B 

linett L I UE(xl,yl)-(x2,y2),switch,BF 

EXAMPLES 

1000 LINE (0,0 

line 

1000 LINE (0,0 

filled-in box 
DESCRIPTION 

LINE is used to draw a line, box (rectangle), or 
filled-in box on the led screen. The xl,yl and x2,y2 
parameters specify two points on the led screen. 
The values used for xl and x2 can be through 
239. The values used for yl and y2 can be 
through 63. The basic line form draws a line from 
point xl.yl to point x2,y2. The next form with 
"switch" option, sets the points if the switch value 
is odd and resets the points if the switch values are 
even. LINE (0, 0) -(LINE (239, 63) ,1 for 
example, sets the points of the line. The B option 
draws or erases a box outline, using the two points 
as opposite corners of the box. The BF option draws 
a filled-in box. Both the B and BF forms require 
that a switch value be used. 

RELATED COMMANDS 

None 



draw diagonal 
9,63] , 1,BF draw 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

Ml, LVL III (4, 4P) 
Ml, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 < 

Model 100, Disk « 




FORMAT 

//ne# LINE INPUT string variable 
linett LINE INPUT "text";string variable 

EXAMPLES 

1000 LINE INPUT "ENTER STREET 
CITY, STATE"; ADS 

DESCRIPTION 

LINE INPUT inputs a line of text entered from 
the keyboard. The input is terminated by an ENTER. 
All keyboard characters are entered as legitimate 
characters. LINE INPUT is unlike INPUT in that 
commas and other delimiters are treated as normal 
text characters and included as part of the result 
string. The "text" parameter is optional. If included, 
the text message is displayed just prior to the input 
operation. The resulting string variable includes all 
characters not including the ENTER character. In 
the example above, a valid input might result in 
AD$="250 N.S. MEMORY LANE, COMPUTER CITY 
CA." 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

Ml, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

lineti LINE mP\JTttbuftt,string variable 

EXAMPLES 

1000 LINE INPUTS3,AD$ input line 
from disk 

DESCRIPTION 

LINE INPUTS inputs a line of text from a disk 
file. LINE INPUTS is unlike INPUTS in that 
commas and other delimiters are treated as normal 
text characters and not as data items. The line is 
input from the disk file up to an ENTER character 
(not preceded by down arrow), the end of file, or 
the 255th data character. The resulting string 
variable includes all characters not including the 
ENTER character. The buf# parameter is the disk 
buffer associated with the file by a prior OPEN 
statement. LINE INPUTS can be used to input 
BASIC program lines when the program has been 
saved in ASCII format, or for other applications 
involving line-oriented text files. 

RELATED COMMANDS 

LINE INPUT 




SYSTEM 

LVL I 

LVLII 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 

Mc-io jS : ? rrsL£f r ^.?i<- v\y* \ 

Model 100 » __'_ -:- - - . , : 

Model 100, Disk • \ 5 

FORMAT 

//ne# LINE INPUTttf/'/e number, string variable 
EXAMPLES 

1000 LINE INPUT83,R$ 

DESCRIPTION 

LINE INPUTB inputs a line of text from a RAM, 
CAS, COM, MDM, or disk file. LINE INPUTB is 
unlike INPUTS in that commas and other 
delimiters are treated as normal text characters and 
not as data items. LINE INPUT is the logical 
equivalent of LINE INPUT from the keyboard, but 
is used with any device file that can be read. The 
line is input from a system device file, the end of 
the file, or the 255th data character. The file 
number must be the file number originally used in 
the OPEN statement when the device file was first 
OPENed. The string variable is the name of the 
string variable that will receive the input data. 
LINE INPUT can be used to input BfiSIC 
program lines when the program has been saved in 
ASCII format, or for other applications involving line- 
oriented text files. 

RELATED COMMANDS 

LINE INPUT 
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SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4. 4P) ■ 
III, Disk (4, 4P) ' 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk * 

FORMAT 

LIST 

LIST nnn-mmm 

LIST -mmm 

LIST nnn- 

//ne# LIST 

EXAMPLES 

LIST 100-999 lists all statements from 100 

through 999 

LIST -9000 lists all statements from beginning 

through 9000 

LIST 100- lists all statements from 100 through 

end 

DESCRIPTION 

LIST is normally used in the command mode to 
list the current BASIC program in RAM to the 
video display. Listing will occur as rapidly as the 
BASIC interpreter can display the BASIC 
statements, and the display will "scroll" as 
successive statements are displayed. The program 
will be listed as a succession of BASIC statements 
in ASCII format. The display can be temporarily 
stopped at any time by pressing "SHIFT, @"; 
pressing any key will restart the listing. LIST used 
in the "nnn-mmm" "-mmm" or "nnn-" formats will 
list from a beginning line through an ending line. 
RELATED COMMANDS 

LLIST 




SYSTEM 

I, LVL I 

I. LVL li * 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P)® 

III, Disk (4, 4P) • 

4, 4P, Disk * 

CC, BASIC • 

CC, Ext BASIC • _ . - 

CC, Disk o 

MC-10 • 

Model 100 • 

Model 100, Disk • 

FORMAT 

LLIST 

LLIST nnn-mmm 

LLIST -mmm 

LLIST nnn- 

linett LLIST 

EXAMPLES 

1000 REM LLIST PROGRAM TO LINE 

PRINTER 

J000 LLIST 

LLIST 100-999 lists all statements from 100 

through 999 

LLIST -9000 lists all statements from beginning 

through 9000 

LLIST 100- lists all statements from 100 

through end 

DESCRIPTION 

LLIST is normally used in the command mode to 

list the current BASIC program in RAM to the 

system line printer. LLIST is logically equivalent 

to LIST, used for displaying the program on the 

video display. Only BASIC statements will be 

listed; no variables or other program parameters will 

be displayed. The program will be listed as a 

succession of BASIC statements in ASCII format. 

LLIST used in the "nnn-mmm" "-mmm" or "nnn-" 

formats will list from a beginning line through an 

ending line. LLIST alone lists the entire program. 

RELATED COMMANDS list 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk • 

II, 12 • 

III, LVL I 
III, LVL III (4, 4P) 

III, Disk (4, 4P) • 

4, 4P, Disk • '- "£„""^^-^_™->-\ - £.'" 
CC, BASIC ^=|~™=™~~===^ 

CC, Ext BASIC >i -■;:;- >-^.U2J. '.-.'/•' ->,"- 

CC, Disk • ' J ifx : ~*r~ ~':'-^z<-\~1?~->\t- 
MC-10 -'JJS^^I J. -.' _. %£ 

Model 100 I 

Model 100, Disk ~ z ~ : " -'" —'- — ~ " 

FORMAT 

LOAD "filename" 
LOAD "filename",R 
linett LOAD "filename" 
linett LOAD "filename"R 

EXAMPLES 

LOAD "ACCOUNTS/BAS:l" load accounts 
payable 

DESCRIPTION 

LOAD loads a BASIC program from disk. If LOAD 
is used without the R option, LOAD will clear all 
variables, close all open files and return to the 
BASIC command mode. If LOAD is used with the 
"R" option, LOAD will clear all variables, will not 
close open files, and will load and execute the 
BASIC program from its first line. LOAD in either 
form may be used in a BASIC statement during 
BASIC program execution. The "filename" is a 
filespec for a BASIC program stored on disk; it 
conforms to the general requirements for filespecs - 
name, extension, password, and drive number. 
LOAD may be used in BASIC programs to "chain" 
programs, allowing one program to call another in a 
chain of "overlays" 

RELATED COMMANDS 

RUN 




SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC J"---- ,■- ••*' 

CC. Ext BASIC " ■ 

CC, Disk 

mc-io : - - . . .-- :-• '•; - ;»" 

Model 100 • "— : ' -12: 

Model 100, Disk * * J 

FORMAT 

LOAD "deviceiilename" 

LORD "devicexonfiguration" 

LORD "device: . . .",/? 

EXAMPLES 

LORD ' ' RAM : SOPT1 ' ' , R load and run 

DESCRIPTION 

LORD loads a BASIC program from RAM, CAS, 
COM, MDM, or disk. The "device" parameter is one 
of the four mnemonics or a disk drive number. The 
"filename" parameter is used for RAM, CAS and disk 
and is the filename under which the file was first 
saved. If the device is RAM or disk, an optional .BA 
or .CO extension can be used as part of the 
filename. A LORD from CAS is logically equivalent 
to the CLORD command. If the filename is omitted 
from a CAS load, the first file found will be loaded. 
If the device is COM or MDM, a five-character string 
is used in lieu of a filename. This string sets up the 
communications parameters. The R (Run) option 
loads the program and then immediately starts 
program execution. Using the R option also leaves 
data files open. 

RELATED COMMANDS 

SAVE, CLORD 




load file "GRRPHC" 



SYSTEM 

LVL I 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I. Disk (4, 4P) 
4, 4P, Disk \J 

CC, BASIC •/- 

CC, Ext BASIC MS 

CC, Disk • /„-' ' 

MC-10 / 

Model 100 f"~~ 

Model 100, Disk "^ m 

FORMAT 

LOADM'Y/'/ename" 
LOfiDM "filename"offset 
EXAMPLES 

LORDM "GRRPHC" 
into RAM 

DESCRIPTION 

LORDM is a Color Computer Disk BRSIC command 
used to load a machine-language file from disk. The 
disk file must have been created by the SRVEM 
command. If the filename is specified without an 
extension, BRSIC assumes that the extension is 
"/BIN"; this is the normal default extension for the 
SRVEM command. If the file is a machine-language 
program, an EXEC can be performed after the 
LORDM to execute the program; BRSIC will start 
execution at the execution address specified in the 
file. If an optional offset is included, the offset 
constant will be added to the normal file load 
address, and the program or data will be 
"relocated" to the resulting RAM addresses. If the 
normal load address was &H3000 to &H30FF and 
the offset was &H500, for example, the data would 
be loaded into RAM locations &H3500 to &H35FF. 
Specifying an offset bias will not properly relocate 
machine-language code. 
RELATED COMMANDS 
EXEC, SRVEM 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 <» 

Model 100, Disk • v ... 

FORMAT 

LOflDM "filename" 
LOADM "CASiilename" 
L Oh D M "drivettfilename " 

EXAMPLES 

LOflDM ''MLPR'' load machine-language 
program 

DESCRIPTION 

LOflDM loads a machine-language program from 
RAM, CAS, or disk. The file must have been 
previously written out to one of these devices with 
the CSflVEM command. The command loads in the 
program to the same place in memory in which it 
originally resided. The first form of the command 
assumes the file is in RAM and loads "filename" 
from RAM with the automatic extension .CO. The 
LOflDM "CAS:filename" form is logically equivalent 
to CLOflDM. The disk file form loads the machine- 
language file from disk. The start, end, and entry 
point addresses are listed on the screen during 
the load. 

RELATED COMMANDS 

CSflVEM, CLOflDM 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) • 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk • 

MC-10 
Model 100 
Model 100, Disk • 

FORMAT 

linett...LOC(buty... 

EXAMPLES 

1000 IF LOG (3) =5 
record 

DESCRIPTION 

LOG is used to find the number of the current 
record in a file. The buf# parameter specifies the 
buffer number or Model 100 file number associated 
with the file. An OPEN must have been performed 
for the buffer (file) involved. As records are read in 
from the file by GET (or INPUTtt for sequential 
files), BASIC maintains the current record number 
of the file and returns this number when LOG is 
executed. LOG is used to detect a specific record 
number as records are read in from disk, or in any 
processing that is "record dependent'.' 

RELATED COMMANDS 

LOF, OPEN 



THEN 5=1 test for fifth 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk • 

II, 12 ° 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) « 
4, 4P, Disk ® 

CC, BASIC 
CC, Ext BASIC 
CC, Disk » 

MC-10 
Model 100 
Model 100, Disk « 

FORMAT 

line#...LOF(buW).. 

EXAMPLES 

1000 FOR 1 TC 
records 

DESCRIPTION 

LOF is used to find the number of the last record 
in a file. The buf# parameter specifies the buffer 
number or Model 100 file number associated with 
the file. An OPEN must have been performed for 
the buffer (file) involved. Once the OPEN is done, 
BfiSIC knows the number of records contained in 
the file and returns this number when LOF is 
executed. The LOF can be used to set up a 
processing loop for the records in the file. LOF is 
used as an alternative to detecting the last record 
number by EOF or knowing the number of records 
in the file beforehand. 

RELATED COMMANDS 

EOF, OPEN 



IIF [ 3 



loop through n 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL 111(4, 4P) 
II. Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk ■ 




FORMAT 

line#...LOG(expression)... 



EXAMPLES 

1000 DB=10* 
decibels 



LOGrP2/Plj/LUOi;i0) J find 



DESCRIPTION 

LOG finds the natural logarithm of a constant, 
variable, or expression, the logarithm to the base e, 
or 2.718.. Jo find the logarithm of the argument to 
another base, use the formula log of X to base b=log 
of X to base e/log of X to base b, as in the example 
above. Natural logarithms are commonly used in 
mathematical and scientific applications. 

RELATED COMMANDS 

EXP 



SYSTEM 




LVLI 
LVLII 
Disk 
12 
I, LVL I 

I. LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk • 

FORMAT 

lineti . . . LPOS(N) 

EXAMPLES 

1000 IF LPOS(0)>23 THEN LPRINT 

DESCRIPTION 

LPOS is used to test the current printer character 
position. The LPOS function returns the current 
logical position of the system printer "print head". 
This is the character position on the paper over 
which the print head would appear if the characters 
were being printed out as they appeared in the 
program. However, because the printer waits for the 
end of the line before printing and for other 
reasons, such as buffering, this "logical" position 
may not be the same as the "physical" position. The 
N value is a "dummy" value which can be any 
numeric value. LPOS is logically equivalent to POS 
except that it is used with the printer and not the 
screen. 

RELATED COMMANDS 

POS 






as* 



SYSTEM 

I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk {4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk ■ 



FORMAT 

lineti LPRINT item list 

EXAMPLES 

1000 LPRINT "THIS IS THE 
RESULT ";R5, "N=";N 
DESCRIPTION 

LPRINT is used to print a list of items on the 
system line printer. LPRINT is the line printer 
equivalent of the PRINT command. The items may 
be string literals (text), string variables, or numeric 
variables. Commas may be used between the items 
to tab to the next print zone, or semicolons may be 
used to avoid spaces between items (see "," and 
";"). There may be any number of items in the list, 
compatible with the maximum BASIC line length. 
Positive numbers are printed with a leading and 
trailing blank. Negative numbers are printed with a 
minus sign and trailing blank. Strings are printed 
with no leading or trailing blanks. If the last item in 
the item list is terminated by a semicolon, the next 
PRINT starts from where the current PRINT left 
off. There are certain codes unique to various line 
printers which control line feeds, expanded printing, 
and special functions. These may be embedded in 
the item list by use of CHR$ or STRINGS. 
RELATED COMMANDS 

",", ":", PRINT 




define 



SYSTEM 

I, LVL I 

I. LVL II * 

I, Disk • 

II, 12 « 

III, LVL I 

III, LVL III (4, 4P)° 
III, Disk (4, 4P) » 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 • 

Model 100, Disk « ^:;. .:...-...;_; ._.. 

FORMAT 

linett LPRINT USING string;item list 
EXAMPLES 

1000 A$= i4 **$tttttt.tt8 DOLLARS 

string 

1010 LPRINT USING A$; TOTAL print check 

DESCRIPTION 

LPRINT USING is used for printing special 
formats on the system line printer, primarily dollar 
amounts and accounting values. The string 
parameter is a literal or variable string that defines 
the format to be used in the printing. The item list 
is a list of numeric or string variables that define 
the items to be printed. If there is more than one 
item, all items will be printed in the format defined 
by the string. The string uses "field specifiers" to 
define certain formats. A "#" specifies a digit 
position. A "." is a decimal point position and is 
printed in the position specified. A "," is printed in 
the position specified. Asterisks (*) fill unused 
positions left of the decimal with asterisks. "$$" or 
"**$" indicate a floating dollar sign, printed before 
the number. The string "**$###,###.## DOLLARS" 
used with variable A=96654.678 generates 
*$96,654.68 DOLLARS. Other specifiers include up 
arrows, plus sign, minus sign, %spaces%, and 
exclamation point. 
RELATED COMMANDS 

PRINT USING 




SYSTEM 

I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4.4P) 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

linett LSET field name=string 

EXAMPLES 

1000 LSET NM$=A$ store addressee name 

DESCRIPTION 

LSET is used to place character data into a 
random-file buffer. The normal sequence of 
operations establishing a random-file buffer is as 
follows: Define the fields of the buffer by a FIELD 
statement. The FIELD establishes the field names 
in the buffer. The RSET and LSET are then used 
to store character data in the fields of the buffer. 
The FIELD statement establishes the size for each 
buffer field. If the data to be stored by LSET is not 
as great as this field size, "filler spaces" would be 
filled on the right. If the field NM$ was 20 
characters, the name "SPIRO SMITH" would be 
stored as "SPIRO SMITH '.' If data to be 

stored by LSET is greater than the field size, 
characters are truncated on the right. The data 
"SPIRO AGOUPOPOPODOUPOLIS" would be stored as 
"SPIRO AGOUPOPOPODOUP'.' 

RELATED COMMANDS 

FIELD, RSET 



MRXFILES. 



SYSTEM 

I. LVL I 
I. LVL II 

I. Disk 

II. 12 

III. LVL I 

III. LVL III (4. 4P) 
III. Disk (4. 4P) 
4, 4P, Disk 
CC. BASIC £T— z^7:r^s^znz^-z^-_2_ 

cc, Ext basic v c^^syTo^-jrr^''^ 

CC. Disk /'^.">^-irgc'r-,^ft b> v V -.>'' \ 

MC-10 ^i^vl^^l^ ;-,- /;p , 

Model 100 • : Lr-^L^ _«^&te^ 

Model 100, Disk • l . J 

FORMAT 

...MRXFILES 
//ne#... MRXFILES... 

EXAMPLES 

PRINT MRXFILES 
1000 MRXFILES=3 

DESCRIPTION 

This variable contains the maximum number of files 
that can be open at any time. The default (initial) 
number is one file. MRXFILES must be changed 
before more than one file is used. If, for example, you 
require three files open at one time, one for input, 
one for output, and one for "sorting", then 
MRXFILES=3 should be used early in the program. 
The MRXFILES variable can be utilized just as any 
other variable — you can display the number or use 
it in comparisions. The number of files refers to all 
files in the system, regardless of device type. 

RELATED COMMANDS 

OPEN 



SYSTEM 



I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 

III, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk I 

MC-10 fi 

Model 100 • lr 

Model 100, Disk • 1 >- 

FORMAT 

. . . MRXPRM 
//'ne# . . . MRXPRM 

EXAMPLES 

CLERR 500,MRXRRf 




DESCRIPTION 

This value is normally equal to the value of the 
maximum memory address for your system — it's 
dependent upon the amount of RAM memory you 
have in your system. MRXPRM cannot be redefined, 
but you can read it like any other variable. 

RELATED COMMANDS 

CLERR , f'IRXRRM 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4. 4P) 

4, 4P, Disk 

CC, BASIC '""--"-" :": ' ' ■'-■ '■' 

CC, Ext BASIC /^=p;^==^==;=^ 

CC, Disk /^:^vxC^t-V;i4i.'! \'!J- 3r ~X 

mc- io ^c>;j6f\\; *:-:-■-. - ,£- ' jtv \ 

Model 100 • / "' £^LzlI£ '" %\ '^vi \ 

Model 100, Disk » '( _ _"_ " "ZIZ^ 

FORMAT i- - 

//ne# MDM ON 
linett MDM OFF 
linett MDM STOP 
EXAMPLES 

1000 MDM UN enable communications interrupt 
DESCRIPTION 

The communications interrupt is used to interrupt a 
BASIC program so that immediate action is taken to 
save a character received from the modem of the 
system. If this action were not taken immediately, the 
character would be lost. The ON MDM GOSUB 
command is first used to define a "processing" 
subroutine for the interrupt. Normally this subroutine 
would read in the character from the MDM file and 
process or save it and then return to the interrupted 
program. The MDM command allows the 
communications interrupt to be enabled or disabled 
by a MDM ON or MDM OFF — there are times when 
the interrupt should be acted upon and other times 
when it should be ignored. The MDM STOP 
"remembers" the interrupt but allows the program to 
ignore it until the next MDM ON, at which point the 
interrupt subroutine is immediately called. 
RELATED COMMANDS 

ON MDM, OPEN 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) . 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

//ne#...MEM. . . 

EXAMPLES 

PRINT MEM 
1000 PRINT 




CM display memory left 



DESCRIPTION 

MEM is a special system function that computes the 
amount of RAM memory currently available. The 
BASIC interpreter finds the amount of memory 
used for BASIC programs, variables, arrays, 
strings, stack, and reserved memory in upper RAM, 
subtracts it from the maximum RAM initially 
available and reports the result for the MEM 
function. This MEM value changes "dynamically" as 
new variables are added, string variables are 
computed, and so forth. MEM may be used from the 
command mode to find the size of a BASIC 
program indirectly (MEM before loading minus MEM 
after loading) or in a BASIC program to compare 
the memory currently available with memory 
required. 

RELATED COMMANDS 

FRE(Model 4) 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

MENU 
linett MENU 

EXAMPLES 

1000 MENU 

DESCRIPTION 

MENU causes a return to the main menu and is 
typically used at the end of a BASIC program. It 
can be used in lieu of END when there is nothing 
further than can be done in BASIC. 

RELATED COMMANDS 

END 




SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) • 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 



FORMAT 

MERGE "filename" 

MERGE "filename"R (Color Computer) 

EXAMPLES 

MERGE ' ' ACCOUNTS/BAS : 1 * ' merge 
accounts payable 

DESCRIPTION 

MERGE loads a BASIC program from disk and 
appends it to the BASIC program in RAM. The 
program specified in the MERGE command must be 
in ASCII format. (It must have been SAVEd with the 
"A" option.) The "filename" is a filespec for a 
BASIC program stored on disk; it conforms to the 
general requirements for filespecs - name, 
extension, drive number, and password. In general, 
the numbering of the program lines to be MERGEd 
from disk and the program in RAM must be 
mutually exclusive. If the line numbers are different, 
the resulting program will be made up of the line 
numbers from both programs in sequence. If any 
line numbers are the same, the lines from the disk 
program will replace the lines of the program in 
RAM. The "R" option for the Color Computer runs 
the program after the merge. 

RELATED COMMANDS 

LOAD, SAVE 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4. 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC __ -" ^ - " 

CC. Ext BASIC ' -r v — n~rr ,r,r-r- '''' 

CC, Disk .'- ; - -'-■-" \ V"" '■ VU' 

Mc-io /.'..-:.v.'-: .*; ._ .-_ ~t •',-- ';■ ' 

Model 100 * :_-_l - _• __-L2 

Model 100, Disk • J 

FORMAT 

MERGE "devicejilename" 
M E P G E ' 'devicexonfigura tion ' ' 
EXAMPLES 

MERGE ' 'RA[1:SECFILE' ' 

DESCRIPTION 

MERGE loads a BASIC program from RAM, CAS, 
COM, MDM, or disk and appends it to the BASIC 
program in RAM. The program specified in the 
MERGE command must be in ASCII format (the "A" 
option in a SAVE). The "device" parameter is one 
of the four mnemonics or a disk drive number. The 
"filename" parameter is used for RAM, CAS, or disk 
and is the same as the name under which the file 
was originally saved. BASIC assumes an extension 
of .DO for RAM or disk files. If a device is not 
specified, BASIC assumes a RAM file. If the device 
is CAS and no filename is specified, the first file 
found on cassette will be loaded. If the device is 
COM or MDM, a "configuration" string defines the 
communications parameters. In general, the 
numbering of program lines to be MERGEd from the 
device file and the RAM file must be mutually 
exclusive to avoid overwriting of the BASIC 
program lines in RAM. 
RELATED COMMANDS 

SAVE 



SYSTEM 




I, LVL I 
I, LVL II 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P)« 

III, Disk (4, 4P) • 

4, 4P, Disk • 
CC, BASIC 

CC. Ext BASIC » .'^T~cx^:rc^f,prr-ri 

CC, Disk • /j-^' , -^'V* ;! '''/''"-' , S 

MC-10 • .^^l^i^'^fe'trf ''-% 

Model 100 • I >:=^ zji Lll! — "'\< 

Model 100, Disk » I 

FORMAT 

Hnett...mD$(string,p,n)... 

EXAMPLES 

1000 A$=MID$fB$,5,2] set A$ equal to the 

5th and 6th characters of B$ 

1010 C$=MID3 ( B$ , 1 , 5 1 set C$ equal to 

LEFTS fB$, 51 

DESCRIPTION 

MID$ returns a "substring" within a larger string. 

The "string" parameter is the larger string to be 

used. The p parameter is the beginning position of 

the substring and may be 1 through 255. The n 

parameter is the length of the substring to be 

created and may be 1 through 255. This command 

takes the specified portion from the middle of the 

larger string and creates a new string. Suppose we 

have the string "MISSISSIPPI" for A$. Setting 

B$=MID$r" AS, 1,4) , B3=MID3f A$,2,41 , 

B3=M I DS f A3 , 3 , 4 1 , and B3=M I D3 f A3 ,8,4 ] 

produces B$ of "MISS',' "ISSI',' "SSIS" and "IPPI" 

respectively. If n is larger than the remaining 

portion of the string, the entire remainder of the 

string is returned. MID3 is useful for processing 

substrings located within larger strings for ease of 

handling. 

RELATED COMMANDS 

LEFT3, RIGHTS 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

linett t']lD , $(string,p,n)=replacement string... 

EXAMPLES 

1000 M I D$ ( R$ , V , 5 ) = ' ' 93555 ' ' change 
to new ZIP 
DESCRIPTION 

MID$ normally returns a substring within a larger 
string. MID$= uses MID$ to find the substring and 
replace it with a given string or portion of a given 
string. The substring and replacement strings are 
normally the same length. The string parameter is a 
string variable containing the substring. The p 
parameter is the beginning position of the substring 
and may be 1 through 255. The n parameter is the 
length of the substring. If A$ in the above example 
was "COMPUTER CITY, CA 92692" and V was 19, 
then the substring would be "92692'.' The MID$ 
function replaces the substring with the given string 
if found. In this example, the new string would be 
"COMPUTER CITY, CA 93555". If the replacement 
string is greater than the length n, only n characters 
of the replacement string will be used. If the 
replacement string in the above example was 
"93555-1234", only the first 5 characters would be 
used. 
RELATED COMMANDS 

MID$ 



SYSTEM 




I, LVL I 
I, LVL II 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) • 
4, 4P, Disk • 

cc, basic -_"_".;^;'J,_"^i" -'-.~';;^ 

CC, Ext BASIC //. „ *-: -r^.- •:'*%.*[ i;-> -: \ 

CC, Disk ?V- >../-; -' - <■ -'-"\-' 

MC-10 '- *' -^'z—.-J. •-"• i"-» _V„» 

Model 100 "~- ~ " *; 

Model 100, Disk 

FORMAT 

line#..M<B$(double-precision variable)... 

EXAMPLES 

1000 fl$=MKD$ ( fitt "J convert M to string 
DESCRIPTION 

MKD$ is used to convert a double-precision 
numeric variable to a "string-type" variable. MKD$ 
is normally used to fill a random-access buffer with 
data values (see LSET, RSET). The typical 
sequence in filling a random-access buffer is to 
define the fields in a random-access buffer with 
FIELD, to convert numeric variables using MKD$, 
MKI$, and Ml<5$, to store the result with LSET 
and RSET and other commands, and to write out 
the buffer to disk. The MKD$ function converts a 
given double-precision variable to an 8-byte string. 
The 8 bytes of the string are the double-precision 
encoding of the numeric data and do not represent 
ASCII characters. They are simply a convenience in 
storing the data in the random-access buffer. The 
CVD reconverts the data to numeric form on a 
subsequent read. The MKD$ command can also be 
used to convert to a normal string variable, which is 
unrelated to a random buffer field name. In this 
case also, the string variable will be 8 bytes long. 
RELATED COMMANDS 



CVD, CVI, CVS, FIELD, MKI$, 
LSET, RSET 



IKS$ , 




SYSTEM 

I. LVL I 
I, LVL II 

I, Disk * 

II, 12 

III, LVL I 

III. LVL III (4, 4P) 
III, Disk (4, 4P) * 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 

CC, Disk ----.-- ~ . -~^ - v -.- 

MC-10 - "'-■-',' •"', 

Model 100 .:.-_-•--... ; ,, 

Model 100, Disk - - 

FORMAT 

linett... Ml< I i(integer variable)... 
EXAMPLES 

1000 R$=MI< I $ i" f\% 1 convert A% to string 
DESCRIPTION 

MKI$ is used to convert an integer numeric 
variable to a "string-type" variable. MKI$ is 
normally used to fill a random-access buffer with 
data values (see LSET, RSET). The typical 
sequence in filling a random-access buffer is to 
define the fields in a random-access buffer with 
FIELD, to convert numeric variables using MKD, 
MKI$ L and Ml<5$, to store the result with LSET' 
and RSET and other commands, and to write out 
the buffer to disk. The MKI$ function converts a 
given integer variable to a 2-byte string. The 2 bytes 
of the string are the integer encoding of the 
numeric data and do not represent ASCII characters. 
They are simply a convenience in storing the data in 
the random-access buffer. The CVI reconverts the 
data to numeric form on a subsequent read. The 
MKI3 command can also be used to convert to a 
normal string variable, which is unrelated to a 
random buffer field name. In this case also the 
string variable will be 2 bytes long and be made up 
of the numeric data of the integer variable. 
RELATED COMMANDS 

CVD, CVI, CVS, FIELD, MKD$ , MKS$, 
LSET, RSET 




SYSTEM 

. LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 

CC, Disk • •-;-'•."-' 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

//ne#...MI<N$(var/aWej... 
EXAMPLES 

1000 fl$=MKN$ ( ft 1 convert A to string 
DESCRIPTION 

MKN$ is used to convert a numeric variable to a 
"string-type" variable. MKN$ is normally used to fill 
a direct-access buffer with data values (see LSET , 
RSET). The typical sequence in filling a direct- 
access buffer is to define the fields in a direct- 
access buffer with FIELD, to convert numeric 
variables using MKN$, to store the result with 
LSET and RSET and other commands, and to 
write out the buffer to disk. The MKN$ function 
converts a given variable to a 5-byte string. The 5 
bytes of the string are the binary encoding of the 
numeric data and do not represent ASCII characters. 
They are simply a convenience in storing the data in 
the direct-access buffer. The CVN reconverts the 
data to numeric form on a subsequent read. The 
MKN$ command can also be used to convert to a 
normal string variable, which is unrelated to a 
buffer field name. In this case also, the string 
variable will be 5 bytes long and be made up of the 
numeric data of the numeric variable. 
RELATED COMMANDS 

CVN, FIELD, RSET, LSET 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk » 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 

III, Disk (4, 4P) • _ 

4 4P. Disk • 

cc. basic r-_ _"*„!, ::z:^' -4— '^> 

cc, Ext basic v <.- . - ;■ c,.>:.-^.-j' *;- v ~i - ' 

cc, Disk -. x ; ? : t --? .,-;.:. y;v, -!*-, ~w'. 

MC-10 r --%-r- .-.. '-•- i' .•-.,•,_/ 
Model 100 
Model 100, Disk 

FORMAT 

line#...\W,S$(single-precision variable)... 

EXAMPLES 

1000 fi$=MI<5$ f ft ) convert A to string 

DESCRIPTION 

MKS$ is used to convert a single-precision numeric 
variable to a "string-type" variable. Ml<5$ is 
normally used to fill a random-access buffer with 
data values (see LSET, RSET). The typical 
sequence in filling a random-access buffer is to 
define the fields in a random-access buffer with 
FIELD, to convert numeric variables using MKD$, 
MKI$, and MKS$, to store the result with LSET 
and RSET and other commands, and to write out 
the buffer to disk. The MKS$ function converts a 
given single-precision variable to an 4-byte string. 
The 4 bytes of the string are the double-precision 
encoding of the numeric data and do not represent 
ASCII characters. They are simply a convenience in 
storing the data in the random-access buffer. The 
CVS reconverts the data to numeric form on a 
subsequent read. The Ml<5$ command can also be 
used to convert to a normal string variable, which is 
unrelated to a random buffer field name. In this 
case also the string variable will be 4 bytes long. 
RELATED COMMANDS 
CVD, CVI, CVS, FIELD, MKD$, MKI$, 
LSET, RSET 



SYSTEM 

I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

//ne# ...expression MOD expression... 

EXAMPLES 

1000 C=R MOD B 

DESCRIPTION 

MOD is a numeric operator that performs a 
"modulus" arithmetic operation on two operands 
and returns a result. The two operands involved 
(constants, variables, or expressions) are converted 
to two-integer operands. A modulus operation 
divides the first operand by the second operand and 
finds the remainder. The remainder is then returned 
as the result of the modulus operation. If the first 
operand is 100, and the second is 44, the result of 
100 MOD 44 is the remainder of 100/44, or 12. 
Modulus arithmetic is useful in such processing as 
finding the "12-" or "24-hour clock" times (elapsed 
hours MOD 12 or 24). 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 

III, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC ■ 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk < 



FORMAT 

MOTOR ON 
linett MOTOR ON 
MOTOR OFF 
linett MOTOR OFF 

EXAMPLES 

1000 MOTOR ON 
3000 MOTOR OFF 

DESCRIPTION 

MOTOR ON turns on the cassette motor by 
activating the cassette "remote" output. The motor 
will remain on until a MOTOR OFF command is 
executed. MOTOR ON can be used to automatically 
control the cassette motor for positioning or other 
uses from within a BASIC program. (The motor is 
automatically turned on, however, by the CLOAD 
and CLOflDM commands.) MOTOR OFF deactivates 
the remote output and turns the cassette motor OFF. 

RELATED COMMANDS 

CLOAD, CLOfiDM 




SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 



FORMAT 

NAME "oldfile" AS "newfile" 

EXAMPLES 

NAME ' ' PROG1 " AS " PR0G2 ' ' 

DESCRIPTION 

NAME changes the name of a RAM or disk file. The 
"oldfile" and "newfile" must be valid file names. 
The "oldfile" name must exist and the "newfile" 
name cannot already exist. Both filenames require 
extensions. If the files are disk files, then the 
filename must be in the disk drive format of drive 
number and colon, followed by the filename. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100. Disk 



IRMET4 



'e. ^J^T'^-^^'-^A}} (Ci'V'fe '» 



usam 



FORMAT 

NAME "oldfile" AS "newfile" 

EXAMPLES 

NRME "PROGl" hS "PR0G2" 

DESCRIPTION 

NRME changes the name of a disk file. The "oldfile' 
and "newfile" must be valid file names. The 
"oldfile" must contain an extension if one is being 
used in the filename. The "newfile" may be any 
valid file name but must not have a password or 
drive specification. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4. 4P) ® 
4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk .--- - 

MC-10 

Model 100 

Model 100, Disk 

FORMAT 

NRME newline,startline,increment 

EXAMPLES 

NRME 100,300,5 from line 100 with start of 
300, increment of 5 
DESCRIPTION 

NRME renumbers the current BRSlu program in 
RAM. All line numbers in the program will be 
changed to a new range of numbers, starting with a 
given number, and with a given increment. This 
includes not only statement line numbers at the 
beginning of BASIC lines, but line numbers 
referenced by GOTOs, GQSUBs, THENs, 
ON. . .GOTOs, and ON. . .GOSUBs. The newline 
parameter is the starting line number of the 
program after renumbering. The startline parameter 
is the first line number of the current program from 
which renumbering is to occur. The increment 
parameter is the increment to be used between new 
line numbers. All parameters are optional. Defaults 
are 10 for "newline" 10 for "increment" and the 
entire program for "startline'.' Commas can be used 
for missing parameters, or NRME can be used by 
itself without parameters to renumber the entire 
program with new line numbers from 10 in 
increments of 10. 
RELATED COMMANDS 
None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P)< 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

NEW 

lineti NEW 

EXAMPLES 

NEW erase old BftSI C program 

DESCRIPTION 

NEW clears any current BASIC program in 
resets all variables to 0, and generally reinitializes 
all BASIC parameters. It does not affect non- 
BASIC data, such as reserved memory areas for 
machine-language programs. NEW should be used to 
"erase" the current BASIC program in memory in 
preparation for entering a new program from the 
keyboard. NEW does not have to be used prior to 
loading in a new BASIC program from disk or 
cassette. NEW would not normally be used in a 
BASIC program statement, as it produces 
catastrophic results and destroys the program. 

RELATED COMMANDS 

None 




SYSTEM 

I. LVL I • 

I, LVL II • 

I, Disk ° 

II, 12 9 

III, LVL I o 
III, LVL III (4. 4P) • 

III, Disk (4, 4P) o 

4, 4P, Disk • s=^=-,- ^^--^..zz °zz.~-j 

CC, BASIC • £R^==S=--=== 1 ' I 

CC, Ext BASIC • V~V ^-.^lif^t If ~/K' 

CC, Disk • Ic-'i^ri rC^^yz^lr'- %\ 

MC-10 • /—■ >-^£:-r^£r— T - \£'^J^\ 

Model 100 • \~'_ ~ "" "* 

Model 100, Disk • ~"~~ " ~ : - " r •'-" — "* - - ' ~ - ' '" 

FORMAT 

linett NEXT variable 
lineti NEXT 
EXAMPLES 

1000 FOR 1=1 TO 100 loop 100 times 
1010 PRINT I print variable 
1020 NEXT I loop 
DESCRIPTION 

The NEXT command is used together with 
FOR. . .TO. . .NEXT to set up and execute a 
program loop. The FOR. . .TO. . .NEXT statement 
defines the start, end, and increment values for a 
variable "counter" used to determine the number of 
passes through the loop. Any number of statements 
may be placed between the FOR. . .TO. . .STEP 
and NEXT statements. The variable in NEXT is 
optional. Any number of FOR. . .TO. . .STEP 
loops may be "nested" In this case, the innermost 
NEXT must always use the variable associated with 
the innermost FOR. . .TO. . .NEXT statement. 
The NEXT statement increments the loop variable 
by the STEP size, and if the variable has not 
exceeded the end value, control is returned back to 
the FOR. . .TO. . .STEP statement. The loop may 
be broken with a GOTO or similar transfer at any 
time. The variable controlling the loop may also be 
altered in statements other than the NEXT. 
RELATED COMMANDS 
FOR... TO... STEP 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 
line#...NQT(expre$sion)... 

EXAMPLES 

1000 IF NOT fFKB) THEN PRINT 

"HELP!" 

1010 fi=NOT(B-lj two's complement 

DESCRIPTION 

NOT is used as a relational operator and for bit 
manipulation. In the first use, NOT tests a constant, 
variable, or expression. If the expression is false, 
then the NOT function is true. In the example 
above, NOT (A<B) is true if variable A is greater or 
equal to variable B. The THEN action would not be 
taken if A was less than B. In the bit manipulation 
case, NOT is used to perform a one's complement 
on an integer variable or end product of an 
expression. A one's complement operates on binary 
values. It "inverts" each bit, changing a one to a 
zero and a zero to a one. The NOT in this 
application can be used to invert bits and perform 
other bit-wise operations. 

RELATED COMMANDS 

FIND, OR 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

IN, LVL 111(4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




find octal value of A 



FORMAT 

Hne#...OCT$(expression)... 

EXAMPLES 

1000 PRINT OCT$(fi) 

DESCRIPTION 

OCT$ is a special function that will convert a 
constant, variable, or expression to a string that 
represents the octal value of the argument. 
OCT$(1000), for example, will be converted to 
the string "1750'.' Octal notation is used primarily 
for machine-language operations in specifying 
addresses, instruction codes, and data values. 

RELATED COMMANDS 

&o 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

lineU ON Cut 




1 GOSLIB Hne# 



EXAMPLES 

1000 ON COM GOSUB 5000 setup com 
interrupt 

DESCRIPTION 

The communications interrupt is used to interrupt a 
BASIC program so that immediate action is taken 
to save a character received from the RS-232-C port 
of the system. If this action were not taken 
immediately, the character would be lost. The ON 
CON GOSLIB command is first used to define a 
"processing" subroutine for the interrupt. This 
command is normally used once, at the beginning of 
the program. Normally the subroutine defined_at 
line# would read in the character from the CON file 
and process or save it and then return to the 
interrupted program. The CON command allows the 
communications interrupt to be enabled or disabled 
by a COM ON or CON OFF — there are times 
when the interrupt should be acted upon and other 
times when it should be ignored. The CON STOP 
"remembers" the interrupt but allows the program 
to ignore it until the next COM ON, at which point 
the interrupt subroutine is immediately called. 
RELATED COMMANDS 



:ot' 



OPEN 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk © imm 

II, 12 9 

Ml, LVL I 

III, LVL III (4. 4P) • 
III, Disk (4, 4P) • 
4, 4P, Disk « 
CC, BASIC r.- -"-■ - :■■--- -:.--.-■: 
CC, Ext BASIC , ^~-^-yrrsz.jnc r 5r>r } 
CC, Disk /;• vO- "^fCK/S^ ''-P-'A^ 
MC-10 /' - —J^t~ ^ : T --" -' \3c: 'P 

Model 100 • ' — !i=-=s: — ^ -m**&m 

Model 100, Disk • 

FORMAT 

linen ON ERROR GOTO linett 
linett ON ERROR GOTO 
EXAMPLES 

1000 ON ERROR GOTO 10000 define error- 
processing routine 

DESCRIPTION 

ON ERROR GOTO is used to define the line 
number of a user error-processing routine. ON 
ERROR GOTO should be defined early in the 
program before errors can occur. After ON ERROR 
GOTO is executed with a valid line number, the 
user error-processing mode is in force, and all 
errors that occur will cause a transfer to the line 
number of the error-processing routine. The user 
error-processing routine can be disabled by 
executing an ON ERROR GOTO command. 
Disabling user error-processing will return to the 
BASIC interpreter's normal error action. The error- 
processing routine normally contains code that will 
detect the type of error (see ERR) and the line in 
which the error occurred (see ERL), in addition to 
code to report the error to the user and recommend 
corrective action. In some cases, the normal BASIC 
error action will be reinstated (see RESUME). 
RELATED COMMANDS 

ERL, ERR, ERROR, RESUME 



>-§M 



wmm 






kg) 



SYSTEM 

I, LVL I • 

I, LVL II * 

I, Disk • 

II, 12 • | 

III, LVL I • 1 
III, LVL III (4. 4P)« :i| 
III, Disk (4, 4P) • ::{ 
4, 4P, Disk • ' 
CC, BASIC «> 

CC, Ext BASIC » 

CC, Disk • 

MC-10 • 

Model 100 • " .• 

Model 100, Disk • 

FORMAT 

linett ON expression GUbUB linett 1, linett 

2,...,linett n 

EXAMPLES 

1000 ON RX GUSUB 

100 , 200 , 300 , 400 , 500 does a GOSUB to 

im'ifAX=l, 200 if AX=2,... 

2000 ON fB-51 GOSUB 

1000 , 2000 , 3000 , 234 does a GOSUB to 

1000 if (B-5)=l, 2000 if (B-5)=2,... 

DESCRIPTION 

This is a "computed guSUB" The quantity before 

the GOSUB may be a constant (trivial), variable, or 

expression. The integer portion of the quantity is 

found. If this is 1, 2, 3, etc., the first, second, third, 

etc. line number is found and a GusUB to the line 

number performed. If the integer portion is 0, or 

greater than the number of line numbers, the next 

statement in sequence is executed. If the integer 

portion is negative or greater than 255, an error 

occurs. The computed GOSUB allows "branching 

out" to a number of subroutines based on a single 

variable: 

1000 REM BRANCH OUT ON MENU 

SELECTION 1-5 

1010 ON N GOSUB 

1000 , 2000 , :J000 , 4000 , 5000 

1020 REN NOT 1-5 HERE OR RETURN POINT 

RELATED COMMANDS GOSUB, ON. . .goto 




GOTO linett 1, linett 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk <• 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P)o 

III, Disk (4, 4P) • 

4, 4P, Disk » II 

CC, BASIC a S 

CC, Ext BASIC • f 

CC, Disk * it 

MC-10 • J£ 

Model 100 • / 

Model 100, Disk • W 

FORMAT 

linett ON expression 
2,...,linett n 
EXAMPLES 

1000 ON AX GOTO 100,200,300,400,500 

does a GOTO to 100 if AX=1, 200 if AX=2,... 

2000 ON (B-5) GOTO 

1000,2000,3000,234 does a GOTO to 1000 

if (B-5)=l, 2000 if (B-5)=2,... 

DESCRIPTION 

This is a "computed GOTO". The quantity before 

the GOSUB may be a constant (trivial), variable, or 

expression. The integer portion of the quantity is 

found. If this is 1, 2, 3, etc., the first, second, third, 

etc. line number is found and a GOTO to the line 

number performed. If the integer portion is 0, or 

greater than the number of line numbers, the next 

statement in sequence is executed. If the integer 

portion is negative or greater than 255, an error 

occurs. Normally the quantity would be a single 

variable or expression. The computed GuTu allows 

"branching out" to a number of lines based on a 

single variable, such as a menu selection: 

1000 REM BRANCH OUT ON MENU 

SELECTION 1-5 

1010 ON N GOTO 

1000 , 2000 , 3000 , 4000 , 5000 

1020 REM NOT 1-5 HERE 

RELATED COMMANDS GOTO, ON... GOSUB 




BUB line# 1, line# 2,...line# n 



SYSTEM 

LVL I 

LVLII 

Disk 

, 12 

I, LVL i 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 
//ne# ON KEY b 
EXAMPLES 

1000 ON KEY UUbUB 

1000 , 2000 , 3000 , , , , , 8000 

DESCRIPTION 

The eight Function Keys may be programmed for 
interrupts. After such programming, pressing a 
Function Key will result in an immediate break to 
the BASIC program being executed and a transfer 
of control to a interrupt processing subroutine. The 
interrupt processing subroutine will contain code to 
perform any special function required. One example 
might be display of the current time. After the 
interrupt subroutine is done, control is returned 
back to the BASIC program at the interrupt point. 
The ON KEY GOSUB command defines the 
Function Key interrupt subroutines. From one to 
eight BASIC line numbers are used after the 
command, corresponding to the eight Function Keys. 
Not all Function Keys must be defined. If a Function 
Key has no corresponding interrupt, then a comma 
is used in place of a line, or there is no line 
number. The KEY command is used to enable or 
disable interrupts. 
RELATED COMMANDS 

KEY 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC ' -- - 

CC, Disk ■-- .-=, -■'' ■ Y 

MC-10 Y •-. ".*" 

Model 100 • 

Model 100, Disk ® 

FORMAT 

linett ON MDM GOSUB //ne# 

EXAMPLES 

1000 ON MDM GOSUB 5000 setup modem 

interrupt 

DESCRIPTION 

The modem interrupt is used to interrupt a BASIC 

program so that immediate action is taken to save a 

character received from the modem of the system. 

If this action were not taken immediately, the 

character would be lost. The ON MDM GOSUB 

command is first used to define a "processing" 

subroutine for the interrupt. This command is 

normally used once, at the beginning of the 

program. Normally the subroutine quickly processes 

the character or saves it and then returns to the 

interrupted program. The MDM command allows the 

communications interrupt to be enabled or disabled 

by a MDM ON or MDM OEE — there are times 

when the interrupt should be acted upon and other 

times when it should be ignored. The MDM STOP 

"remembers" the interrupt but allows the program 

to ignore it until the next MDM ON, at which point 

the interrupt subroutine is immediately called. 

RELATED COMMANDS 

MDM, OPEN 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC '; ~_-.:-^aia=rj^:^ 

cc. Ext basic fe^^^saSarin-rv i 

CC, Disk /'?v>/^":^>,r>4H-'-— i^lf ' 

MC-10 ,{^"i^iLi^> : >.;£^ fe -p\ 

Model 100 • i £^==-~ __»**Js^ 

Model 100, Disk • ''■•~~~^-~.;:_-.-..-:.-s....:---^-^ - 

FORMAT 

linett ON TIME3...G0SUB linett 

EXAMPLES 

1000 ON TIME$="23:59:59" GOSUB 

5000 

DESCRIPTION 

If the current time is entered into the system via a 
TIMES command, then the system will keep track 
of the current time continually. The ON TIMES 
GOSUB command provides for a system "interrupt" 
at a designated time. When such an interrupt 
occurs, the current BASIC will be interrupted and 
a special interrupt processing subroutine will be 
entered. The interrupt processing subroutine is 
defined by the user and may perform any action 
desired. The ON TIMES GOSUB command defines 
the time of the interrupt and specifies the line 
number of the interrupt processing subroutine. The 
TIMES command enables or disables the TIMES 
interrupt. The TIMES time string in the ON 
TIMES GOSUB must be in the standard 
' 'HH:MM:SS' * format and contain eight 
characters in 24-hour format. 

RELATED COMMANDS 



TIMES 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk • 

II, 12 * 

III, LVL I 

III. LVL III (4, 4P) 
III, Disk (4, 4P) * 
4, 4P, Disk ® 

CC, BASIC " . __..". - 

CC, Ext BASIC 

CC, Disk <• . ; , : - 

MC-10 •- - •••■' "■•-. 

Model 100 

Model 100, Disk 

FORMAT 

linett OPEN mode, buftt, filename 

linett OPEN mode, buftt, filename, rec-length 

EXAMPLES 

1000 OPEN ' '0' ',1, ' 'PAYABLE :1" 
open payables file 

DESCRIPTION 

OPEN causes BASIC to initiate, extend, or locate a 
disk file, to establish a RAM buffer for disk 
operations, and to establish a record length. The 
mode parameter is a one-character string that 
establishes the basic operation. "I" specifies 
sequential input starting at the first record. "0" 
specifies sequential output starting at the first 
record. If the filename does not exist, a new file is 
created. "E" (not used in the Color Computer.) 
appends output to the end of an existing file (or 
creates a new file). "R" ("D" in the Color Computer 
for "direct-access" file) specifies random 
input/output of a file. If mode is a constant, it must 
be enclosed in quotes. The buf# parameter is a 
numeric value specifying the buffer number. The 
filename parameter is a standard file specification. A 
constant must be enclosed in quotes. The rec-length 
parameter is optional for the "R" mode. If not used, 
256 bytes is used for the length. 

RELATED COMMANDS 

CLOSE 




SYSTEM 

I, LVL I • 

I, LVL II • 

I, Disk • 

II, 12 • 

III, LVL I • 
III, LVL III (4, 4P)e 
III, Disk (4, 4P) • 
4, 4P, Disk 8 
CC, BASIC • 
CC, Ext BASIC 
CC, Disk • 
MC-10 
Model 100 
Model 100, Disk 

FORMAT v «Ncr-^rr^t-_^- ,~^^"-^—-^ 

/;ne# OPEN "device:filename" FOR mode RS fileti 

linett OPEN "COMxonfiguration" FOR mode RS f/7e# 

linett OPEN "MDM:configuration" FOR mode fib 

filett 

//ne# riPEN "iCD:" FOR OUPUT fiS filett 

linen OPEN 'W FOR output fiS filett 

EXAMPLES 

1000 OPEN "RfiM:RECEV.Bfi" FOP 

OUTPUT fiS 1 

2000 riPEN "LPT: * ' FOR OUTPUT fib J 

DESCRIPTION 

OPEN causes BfiSIC to initiate or extend a device 
file. The devices are RAM, CAS, COM, LCD, LPT, MDM, 
or CRT (disk system only). Device files may be read 
from or written to in the case of RAM, CAS, COM, 
MDM, or disk. LCD, LPT, and CRT files can only be 
written to. Disk filenames must be preceded by a drive 
# 0: or 1:). "Mode" is OUTPUT for a write, 
INPUT for a read, or APPEND for a write to the end 
of an existing file. The "file#" parameter is a number 
starting from 1 that relates a file with a file buffer. The 
file tt is used for many other BfiSIC commands 
involving reading from or writing to the file. "Filename" 
is used for RAM or CAS files to identify the file within 
RAM or on cassette. The "configuration" string defines 
communications parameters. 
RELATED COMMANDS 
INPUTS, PRINTS, LINE INPUTS, 
INPUTS, PRINTS USING 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk 

MC-10 / 

Model 100 f> 

Model 100, Disk v 

FORMAT 

linett OPTION BASE 

EXAMPLES 

OPTION BfiSE 1 

DESCRIPTION 

OPTION BfiSE sets the lowest value that an array 
can have to N, either or 1. You should use the 
OPTION BfiSE command before any arrays are 
used. Often you'd like to use only elements in arrays 
numbered from 1 on for clarity, disregarding the Oth 
element. In these cases, OPTION BfiSE should 
be used to eliminate the Oth element in all arrays. 
The default value is OPTION BfiSE 0, which is in 
force even if the OPTION BfiSE command is 
not used. 

RELATED COMMANDS 

DIM 



set lowest sub to 1 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk <» 

II, 12 «» 

III, LVL I 

III, LVL III (4, 4P)« 
III, Disk (4. 4P) • 
4, 4P, Disk » 

CC. BASIC « _ .._ 

cc. Ext basic » /> -;v l-.-SV'Vj: : : ,.' <"V 

CC, Disk • .•/--- A- '.-".' "•'> -i' 1 ' - : >. 

MC-10 • '- " ^-^_.y; ■"«->. IVv^:' 

Model 100 • s v " "" 

Model 100, Disk • '* ' " " - ■ - "-" -' r ~ ■ - 

FORMAT 

linett... (expression) OR (expression)... 

EXAMPLES 

1000 IF (fl<2) OR (B>5) THEN PRINT 
"HELP!" 

1010 A=fl OR 8 set bit 3 
DESCRIPTION 

OR is used as a relational operator and for bit 
manipulation. In the first use, OR compares two 
constants, variables, or expressions. If either 
expression is true, then the OR function is true. In 
the example above, (A<2) fiND (B>5) is true if 
variable A is less than 2 OR variable B is greater 
than 5. The THEN action would only'be taken if 
either expression was true (expression 1 OR 
expression 2). In the bit manipulation case, OR is 
used to logically OR integer variable bits, considered 
to be binary numbers. An OR of binary values 
produces a 1 for each bit position if either operand 
has a 1 bit in that bit position. An OR of the two 
binary values 10100000 and 11001111 would 
produce a result of 11101111. The OR in this 
application can be used to test bits, set individual 
bits, and perform other bit-wise operations. 
RELATED COMMANDS 

AND, NOT 



SYSTEM 




1, LVL 1 

1, LVL II • 

I, Disk • 

II, 12 i 

III, LVLI ! 
Ill, LVL III (4, 4P)« 

III, Disk (4, 4P) ® j 

4, 4P, Disk • ! 

CC, BASIC 

CC, Ext BASIC 1 

CC, Disk / 

MC-10 

Model 100 • f- 

Model 100, Disk • l - 


. _____^.. . . .. ^ 


"SIS?" 


tSSSESESBal JjSSHiSSHf 


FORMAT 




lineti OUT port,value 




EXAMPLES 




1000 OUT 255,2 


turn Model 1 cassette on 


1010 OUT 255.1 


turn Model 1 cassette off 


1030 GOTO 1000 


loop 



DESCRIPTION 

OUT is a command that outputs a one-byte value to 



a system I/O port. Systems that use Z-80 or 
microprocessors use I/O ports for certain system 
devices such as cassette or RS-232-C. The OUT 
enables a BASIC program to directly output data 
to these I/O ports. The port parameter is an address 
value of through 255 that defines the I/O 
address. The value parameter is a one-byte value of 
through 255 that represents the data to be output 
to the I/O port. 

RELATED COMMANDS 

INP 




I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

lineU Pf\lHl(x,y),c,b 

EXAMPLES 

1000 PRINT (120, 100), 3, 4 paint with 
blue until red 

DESCRIPTION 

The PRINT command colors an area on a graphics 
screen. The x,y coordinate defines a starting point 
for the paint. The x,y coordinates are in "high- 
resolution" coordinates of 0-255 and 0-191. The c 
and b parameters are standard color code of 1 
through 8 (green, yellow, blue, red, buff, cyan, 
magenta, and orange). The c parameter defines the 
color for the paint; the b parameter defines the ^ 
"boundary" color. The painting will "spread out" 
from the starting point until the specified boundary 
color is encountered . If the boundary color is not 
found, or if it does not completely contain the 
PRINT area, the PRINT operation will continue 
over the entire screen (or until a proper boundary 
condition). 



RELATED COMMANDS 

None 



LVL I 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

linen PCLEfiR n 

EXAMPLES 

linen PCLEfiR 8 clear 8 graphics pages 

DESCRIPTION 

PCLEfiR reserves n number of graphics pages. The 
graphics pages are separate from the text screen in 
the Color Computer. Each graphics page is 1536 
bytes long, and up to 8 pages may be used for 
display of graphics data. Depending upon the 
PMODE in force, anywhere from 1 to 4 pages may 
be on display at any time; the remaining pages are 
used as storage for additional graphics data. The 
starting page number may be changed by the 
PMODE command. If PCLEfiR is never executed, 
the default number of graphics pages reserved is 4. 
PCLEfiR does not clear the graphics pages (see 
PCLS). 

RELATED COMMANDS 

PCLS, PMODE, SCREEN 




SYSTEM 

I, LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC • :; • 

CC, Disk @ . ' ■ • '•''-- 

MC-10 ,- ... - " _ r 

Model 100 

Model 100, Disk . . .; - 

FORMAT 
//ne# PCLS color 

EXAMPLES 

1000 PCLS 8 clear the screen to orange 

DESCRIPTION 

Pi-L'n is the Extended Color BASIC equivalent of 
the r.LS command. It clears the current graphics 
screen with the specified color. Valid colors are 1 
through 8, representing green, yellow, blue, red 
buff cyan, magenta, and orange, respectively. The 
color specified must be in the color set currently 
selected. If the color selected is not in the current 
color set, the screen will be cleared to a 
"corresponding" color in the current color set 
Pi-LS R while in color set 0, for example, will clear 
the graphics display to red if in a four-color mode. 
Pi-ls 8 while in color set and a two-color mode 
will clear the graphics screen to black. The graphics 
screen does not have to be on display for the PCLb 
to take effect. As the graphics pages are separate 
from the text screen, they can be cleared 
independently. 

RELATED COMMANDS 
SCREEN 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

line^ PCOPY n TO m 

EXAMPLES 

1000 PCOPY 1 TO 8 

DESCRIPTION 

PCOPY is used to copy the contents of one graphic 
page to another graphics page. There are 8 graphics 
pages in Extended Color BR5IC in the Color 
Computer, numbered 1 through 8. Any page may be 
copied to another page for purposes of initialization 
or temporary storage. PCOPY copies only the 1536 
bytes of one page (n) to another (m). If the graphics 
mode in force uses more than one page for graphics 
display, then more than one PCOPY may have to 
be done to display all of the graphics data. The 
"source" page, the page to be copied, remains 
unaltered after the copy. 

RELATED COMMANDS 

PMODE 



SYSTEM 

LVL I 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

//'ne#. . . PEEK (expression). . . 

EXAMPLES 

1000 FOR 1=31000 TO 31000+14 setup 

loop 

1010 PRINT PEEKflj print byte 

1020 NEXT I continue 

DESCRIPTION 

PEEK is a function that allows you to look at a byte 
of memory in ROM, RAM, or "memory-mapped" I/O 
device. It returns the contents of a single memory 
location whose address is specified by a constant, 
variable, or expression within parentheses after the 
PEEK. As all memory locations in the TRS-80 
systems contain 8 bits or one byte of data, the 
contents will be a value from through 255. PEEK 
can be used in conjunction with POKE to process 
bytes of memory for combining BASIC programs 
with machine-language programs. PEEK can also be 
used to examine certain I/O devices whose 
addresses simulate memory locations. 

RELATED COMMANDS 

POKE 



^= 



1==^ 




S3^ 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

ill, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC • 
CC, Disk • 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

//ne# PLAY string 

EXAMPLES 

1000 PLAY "C;D;E;F;G;A;B;C" play 
scale 

DESCRIPTION 

PLAY plays a string of musical notes with control of 
frequency, note length, tempo, volume, and pauses. 
The "string" argument is a string constant or 
variable that defines the PLAY operations. The 
general format is a series of "subcommands" 
separated by semicolons. The letters from A through 
G specify note value subcommands. A suffix of "+", 
"#" indicates a sharp, and "-" indicates a flat. (A# 
is A sharp.) Nl through N12 also indicate note 
values. followed by 1 through 5 indicate the 
octave. L followed by 1 through 255 indicates the 
note length (1 is a whole note, 2 a half note, 4 a 
quarter note, etc.) T followed by 1 through 255 is 
tempo, slow to fast. V followed by 1 through 31 is 
volume, low to high. P followed by 1 through 255 is 
pause length. Substrings may be executed by X 
followed by substring to be executed. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 

CC, BASIC , _ ''__,.. ,, 

CC, Ext BASIC 

CC, Disk • -;. - ••''%,'. 

MC-10 '._.". -.- -• ' ; ' V 

Model 100 
Model 100, Disk 

FORMAT 

//'ne# PMODE mode.start-page 

EXAMPLES 

1000 PMODE 3,1 select PMODE 3, start-page 1 

DESCRIPTION 

PMODE is used to select the graphics resolution 
and starting graphics page number in Extended 
Color Basic. The mode parameter selects one of 5 
modes, numbered through 4. The resolution of the 
graphics screen increases with the mode number. 
Mode is a two-color 128 by 96 mode, mode 1 is a 
four-color 128 by 96 mode, mode 2 is a two-color 
128 by 192 mode, mode 3 is a four-color 128 by 
192 mode, and mode 4 is a two-color 256 by 192 
mode. The color set displayed depends upon the 
SCREEN command. Two-color modes display black 
on green (set 0) or black on buff (set 1). Four-color 
modes display green, yellow, blue, red (set 0) or 
buff, cyan, magenta, orange (set 1). The start-page 
may be any graphics page from 1 to 8. The PMODE 
command does not cause a display of the graphics 
page; SCREEN sets either a text display or graphics 
data. 
RELATED COMMANDS 

SCREEN 






POINT 






/r* 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4.4P)' 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 _ 

Model 100, Disk '{ " 

FORMAT 

linen POINTfXVj 

EXAMPLES 

1010 R=PO I NT (63, 31 j read contents of pixel 

DESCRIPTION 

Model l/lll: POINT is used to test one graphics 
"pixel" There are 6144 pixels, divided up as 128 
horizontal elements by 48 vertical elements. The 
POINT command tests one of these pixels for "on" 
or "off" status. Each of the 6144 pixels can be 
uniquely tested. The x coordinate specifies the 
horizontal position of 0-127. The y coordinate 
specifies the vertical position of 0-47. If the point is 
"on" POINT returns a -1. If the point is "off" 
POINT returns a 0. 

Color Computer and MC-10: POINT is used to test 
one graphics "pixel" for "off" or "on'.' There are 
2048 pixels, divided up into 64 horizontal elements 
by 32 vertical elements. The x coordinate specifies 
the horizontal position of 0-63. The y coordinate 
specifies the vertical position of 0-31. If the point is 
"off; a is returned. If "on" in the graphics mode, 
the color code of 1 through 8 (green, yellow, blue, 
red, buff, cyan, magenta, orange) is returned. If in 
the character mode, a -1 is returned. 

RELATED COMMANDS 

CLS, RESET, SET 



SYSTEM 




I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//r?e#...POKE expression,value... 

EXAMPLES 

1000 FOR 1=31000 TO 31000+14 set up 

loop 

1010 POKE 1 , clear bytes 

1020 NEXT I continue 

DESCRIPTION 

POKE is a function that allows you to store data in 
memory locations in RAM, or "memory-mapped" I/O 
devices. A value of through 255 is stored in the 
memory location specified by a constant, variable, 
or expression. As all memory locations in the TRS-80 
systems contain 8 bits or a byte of data, values 
greater than 255 are not valid. POKE can be used 
in conjunction with PEEK to process bytes of 
memory for combining BASIC programs with 
machine-language programs. POKE can also be 
used to output to certain I/O devices whose 
addresses simulate memory locations. 

RELATED COMMANDS 

PEEK 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I. 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 



FORMAT 
line#...PQS(dummy)... 

EXAMPLES 

1000 PRINT V;ThB(PO< 
spaces 




) +.J ] insert 3 



DESCRIPTION 

POS is a function that returns the current cursor 
position of the video display, from through 63 
(Model l/lll), though 79 (Model II, 12, Model 4), 
through 31 (Color Computer), or 0-39 (Model 100). 
POS may be used for columnization or word- 
processing applications. 

RELATED COMMANDS 
None 




ME 



set automatic power down 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 

III, Disk (4, 4P) jlj 

4, 4P, Disk 1 

CC, BASIC S 

CC, Ext BASIC f 

CC, Disk h 

MC-10 It 

Model 100 • l_ 

Model 100, Disk • ^ 

FORMAT 

POWER OFE 
lineti POWER OFF, RE! 
POWER CONT 
POWER expression 

EXAMPLES 

1000 POWER 20 

DESCRIPTION 

POWER controls the automatic power down feature 
of the system. The system draws least power when 
it is in the off condition and an automatic power 
down feature preserves battery life. The default 
value for the automatic power down is 10 minutes; 
if left unattended for this period, the system will 
turn itself off. This period can be changed by the 
POWER command with a numeric value. Each count 
of the numeric value is 1/10 minute. A POWER 20, 
for example, changes the power down period to 
20/10ths of a minute or two minutes. A POWER 
CONT disables the automatic power down feature of 
the system — the system will never shut itself off 
after this command. The POWER OFF command 
turns off the power immediately. The POWER 
OFF, RESUME option of this command causes the 
system to resume execution at the next statement 
when the power is again turned on. 
RELATED COMMANDS 
None 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I. 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

linett PPOINTftyj 

EXAMPLES 

PPOINT (128,96' 



test middle element 



DESCRIPTION 

PPOINT is used to test one graphic element on the 
current graphics page. The "x" and "y" parameters 
define the horizontal and vertical element numbers, 
respectively. The x value can range from through 
255; the y value can range from through 191. The 
coordinates specify an element in the highest 
graphics resolution of 256 by 192 elements. The 
actual area tested depends upon the current 
PMODE resolution for graphics. The element will be 
tested even if the current display is of the text 
page. PPOINT returns the color code for the 
graphics element defined by x and y. Color codes 
are 1 through 8 defining colors of green, yellow, 
blue, red, buff, cyan, magenta, and orange. 

RELATED COMMANDS 

PRESET, PSET 




SYSTEM 

, LVLI 
, LVL II 

, Disk 

I, 12 

II. LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 



FORMAT 

linen PRESET (x,y) 

EXAMPLES 

1000 PRESET ( 129 , 96 ) reset middle dot 

DESCRIPTION 

PRESET is used to reset one graphic element on 
the current graphics page. The x and y parameters 
define the horizontal and vertical element numbers, 
respectively. The x value can range from through 
255; the y value can range from through 191. The 
coordinates specify an element in the highest 
graphics resolution of 256 by 192 elements. The 
actual area reset depends upon the current PMODE 
resolution set for graphics. The element will be reset 
regardless of the display of the current page. The 
color used for the reset action is the current 
background color. If SCREEN has specified the text 
page, no action will be seen, but the PRESET 
action has occurred. "PRESET" is also used in the 
LINE command, where it means "draw the line or 
box in current background color" effectively 
"resetting" the line. 

RELATED COMMANDS 

LINE, PSET 



SYSTEM 



, LVL I 
. LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk < 




FORMAT 

linen PRESET (x,y) 

EXAMPLES 

1000 PRESET (120. 



reset middle pixel 



DESCRIPTION 

PRESET is used to reset one pixel on the screen. 
The x and y parameters define the horizontal and 
vertical element numbers, respectively. The x value 
can range from through 239; the y value can 
range from through 63. PRESET can be used at 
any time, even though text characters also occupy 
the screen. Figures are drawn by a succession of 
properly oriented pixels set by PSET and reset by 
PRESET commands. 

RELATED COMMANDS 

PSET 




SYSTEM 

, LVL I • 

, LVL II 

, Disk • 

I, 12 * 

II, LVL I » 
II, LVL III (4. 4P) • 
II, Disk (4, 4P) • 

4, 4P, Disk » 

CC, BASIC • i-----^---^-.^.----." -1 

CC, Ext BASIC • ./„,_--__-,__- _-,r . 

CC, Disk • 'H--.v -"->.-' •">":'.' ' ;'^ 

mc-io • ■— % r - : ~ ' : * : ; - - ;.'-'.,- .: " - 

Model 100 • ==^- ~ ^ 

Model 100, Disk • 

FORMAT 

I'meU PRINT item list 
EXAMPLES 

1000 PRINT "THIS IS THE 
RESULT ";RS,"N=";N 
DESCRIPTION 

PRINT is used to display a list of items on the 
video display. The items are generally printed on 
one line or a portion of one line. The items may be 
string literals (text), string variables, or numeric 
variables. Commas may be used between the items 
to tab to the next print zone, or semicolons may be 
used to avoid spaces between items (see "," and 
";"). The example above prints one line of "THIS 
IS THE RESULT XXX N= XXX',' where XXX 
represents the value of variables RS and N. There 
may be any number of items in the list, compatible 
with the maximum BASIC line length. Positive 
numbers are printed with a leading and trailing 
blank. Negative numbers are printed with a minus 
sign and trailing blank. Strings are printed with no 
leading or trailing blanks. If the last item in the item 
list is terminated by a semicolon, the next PRINT 
starts from the point at which the current PRINT 
left off. 

RELATED COMMANDS 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4. 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//'ne# PR I NTS ( R , C j jtem list 

EXAMPLES 

1000 PRINTS (12,32), "SCREEN 
CENTER" 

DESCRIPTION 

PRINTS (R,Cj performs an identical function to 
PRINTS — it displays the values of variables or 
strings at a specified location on the screen. In this 
command, however, the location on the screen is 
given in row, column coordinates. The R parameter 
is a value from through 23 and defines a row or 
screen line. The C parameter is a value from 
through 79 and defines a character position within 
the row. The remainder of the statement is an item 
list identical to the PRINT command. Numeric 
variables, string variables, or literal values may be 
specified in the list. Commas between items result in 
tabs to the next print position. Semicolons between 
items avoid spaces between items. 

RELATED COMMANDS 

PRINT 



SYSTEM 

I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 






PRINTtt 
PRINTtt USING 

1100] 






FORMAT 

linett PRINTtt fileti, item list 

///?e# PRINTtt filett, USING "string";item list 

EXAMPLES 

1000 PR I NT83 , R , B , C , D$ output values 

DESCRIPTION 

PRINTtt performs a write to the file associated 
with the "file#" parameter. The file must have been 
previously OPENed. The OPEN command specifies 
a buffer number for the device file and this buffer 
number is used in the PRINTtt command. 
PRINTtt is similar to the display output of PRINT, 
except that the items go to a device file. The items 
may be any number of numeric or string variables. 
All items are transformed into character strings and 
written to the device file. If commas are used to 
separate the items, spaces for tabs will be written. If 
semicolons are used, no spaces will be written. The 
USING option outputs the list in the format 
specified by the USING string. The format is 
identical to that used in PRINT USING. 

RELATED COMMANDS 

PRINT USING, PRINT 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk e 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) » 
4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC '------r-^.j-irr-^ 

CC, Disk • ..'-.' . ; - 
MC-10 

Model 100 ( - - ' - - -1 

Model 100, Disk 

FORMAT 

//ne# PRlNTtt/wf#,/fem list 
linett PRINTtt MOUSING stringjtem list 
EXAMPLES 

1000 PR I NTtt 3 , R : B ; C$ output to file 
DESCRIPTION 

PRINTtt performs a write to a sequential disk file. 
The file must have been previously OPENed. The 
UPEN command specifies a buffer for the file name, 
and this buffer number is used in the PRINTtt 
command. PRINTtt outputs a list of items to the 
buffer (file). The items may be any number of 
numeric or string variables. All items are 
transformed into character strings and written to the 
disk buffer. The PRINTtt output to the file is 
similar to the display output of PRINT. If commas 
are used to separate the items, spaces for tabs will 
be written. If semicolons are used, no spaces will be 
used between items. String variables should use 
l:HR$(:j4 1 to bracket the variables with double 
quotes if the string variables contain delimiters such 
as commas or semicolons; otherwise string variables 
can be used in the list as required. The USING 
option outputs the list in the format specified by the 
USING string. The format is identical to that used 
in PRINT USING. 

RELATED COMMANDS 

PRINT USING 



SYSTEM 



, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II. Disk (4. 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

linett PRlNTtU'tem list 

EXAMPLES 

1000 PRINTS, R,B,C$, ' »****' ' 

DESCRIPTION 

PRINTS outputs the specified item list to cassette 
tape. The cassette tape must have been positioned 
to the proper point for file output, PRINTS is 
similar to the PRINT display statement. It outputs 
character strings to the cassette after converting 
numeric variables. Any number of items may be 
used in the item list in any combination of 
constants, numeric variables, string literals, or string 
variables. Each item must be separated by a 
delimiter of a comma or semicolon. The maximum 
length of characters output to tape must not exceed 
248; this is a function of the number and lengths of 
items in the list. Items output to a cassette file can 
be read in by the INPUTS command; input must 
be in the same sequence as output. 

RELATED COMMANDS 

INPUTS, PRINT 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II. LVL I 

II, LVL III (4, 4P)' 
II, Disk (4, 4P) - 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

linen PRINTS-l,/'fem//'sf 



EXAMPLES 

1000 PRINTS- 



l,fl,6,C$, ******" 



DESCRIPTION 

PRINTS-l outputs the specified item list to 
cassette tape. The cassette tape must have been 
positioned to the proper point for file output. 
PRINTS-l is similar to the PRINT display 
statement. It outputs character strings to the 
cassette after converting numeric variables. Any 
number of items may be used in the item list in any 
combination of constants, numeric variables, string 
literals, or string variables. Each item must be 
separated by a delimiter of a comma or semicolon. 
The maximum length of characters output to tape 
must not exceed 248; this is a function of the 
number and lengths of items in the list. Items 
output to a cassette file can be read in by the 
INPUTS-l command; input must be in the same 
sequence as output. 

RELATED COMMANDS 

INPUTS-l, PRINT 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

linen PRINT8- 
EXAMPLES 

1000 PRINTS- 




z, item list 



"THIS IS THE 



RESULT" ;RS,"N=";N 
DESCRIPTION 

PRINT8-2 is used to print a list of items on the 
system line printer. PRINT8-2 is the line printer 
equivalent of the video display PRINT command. 
The items may be string literals (text), string 
variables, or numeric variables. Commas may be 
used between the items to tab to the next print 
zone, or semicolons may be used to avoid spaces 
between items (see "," and ";"). There may be any 
number of items in the list, compatible with the 
maximum BASIC line length. Positive numbers are 
printed with a leading and trailing blank. Negative 
numbers are printed with a minus sign and trailing 
blank. Strings are printed with no leading or trailing 
blanks. If the last item in the item list is terminated 
by a semicolon, the next PRINT starts from the 
last PRINT position. There are certain codes 
unique to various line printers which control line 
feeds, expanded printing, and special functions. 
These may be embedded in the item list by use of 

CHR$ or STRINGS. 

RELATED COMMANDS 

",", ";", PRINT 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
Ml, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//ne# PRINT8-2,/'fem//sf 

EXAMPLES 

1000 PRINT8-2,fi,B,C$, ' '**#*' ' 

DESCRIPTION 

PRINT8-2 is identical to PRINT8-1 except that 
it is used for the second cassette of the system. 
PRINT8-2 outputs the specified item list to 
cassette tape. The cassette tape must have been 
positioned to the proper point for file output. 
PRINT8-2 is similar to the PRINT display 
statement. It outputs character strings to the 
cassette after converting numeric variables. Any 
number of items may be used in the item list in any 
combination of constants, numeric variables, string 
literals, or string variables. Each item must be 
separated by a delimiter of a comma or semicolon. 
The maximum length of characters output to tape 
must not exceed 248; this is a function of the 
number and lengths of items in the list. Items 
output to a cassette file can be read in by the 
INPUT8-2 command; input must be in the same 
sequence as output. 

RELATED COMMANDS 

INPUT8-2, PRINT 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P)° 

III, Disk (4, 4P) • 

4, 4P, Disk • 
CC, BASIC 

CC. Ext BASIC ® -,._-- .___-_-_-«. 

CC, Disk • --Y. - - " -"' ! . - - -■', 

MC-10 o 

Model ioo • L_?"£L_' " ■' - ^.-az: 

Model 100, Disk • 

FORMAT 

linett PRINT ^position .item list 
EXAMPLES 

1000 PRINT 0128, "THIS IS THE 
RESULT ";RS,"N=";N 

DESCRIPTION 

PRINT @ is used to display a list of items on the 
video display at a specified starting location. The 
items may be string literals (text), string variables, 
or numeric variables. Commas may be used between 
the items to tab to the next print zone, or 
semicolons may be used to avoid spaces between 
items (see "," and ";")■ The Model I and III have 
1024 print positions; each line starts with a multiple 
of 64. The Models II, 12, and 4 have 1920 print 
positions; each line starts with a multiple of 80. The 
Color Computer and MC-10 have 512 print positions; 
each line starts with a multiple of 32. The Model 
100 has 320 print positions; each line starts with a 
multiple of 40. Print positions are numbered starting 
from 0. There may be any number of items in the 
list, compatible with the maximum BASIC line 
length. Positive numbers are printed with a leading 
and trailing blank. Negative numbers are printed 
with a minus sign and trailing blank. Strings are 
printed with no leading or trailing blanks. 
RELATED COMMANDS ",'\ "; ", PRINT 




SYSTEM 

I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

///?e# PRINT AT positionjtem list 
EXAMPLES 

1000 PRINT AT 128, "THIS IS THE 
RESULT ";RS,"N=";N 

DESCRIPTION 

PRINT AT is used to display a list of items on the 
video display at a specified starting location. The 
items are generally printed on one line or a portion 
of one line. The items may be string literals (text), 
string variables, or numeric variables. Commas may 
be used between the items to tab to the next print 
zone, or semicolons may be used to avoid spaces 
between items (see "," and ";")• In the example 
above, the message is printed beginning at print 
position 128. The Model I has 1024 print positions; 
each line starts with a multiple of 64. There may be 
any number of items in the list, compatible with the 
maximum BASIC line length. Positive numbers are 
printed with a leading and trailing blank. Negative 
numbers are printed with a minus sign and trailing 
blank. Strings are printed with no leading or trailing 
blanks. If the last item in the item list is terminated 
by a semicolon, the next PRINT starts from the 
point at which the current PRINT left off. 
RELATED COMMANDS 
",", ";", PRINT 



,-■■ 




string; item list 



SYSTEM 

I, LVL I 

I, LVL II * 

I, Disk • 

II, 12 

III, LVL I 

III, LVL III (4, 4P) • 

III, Disk (4, 4P) » 

4, 4P, Disk • 
CC, BASIC 

CC, Ext BASIC « 

CC, Disk • 
MC-10 

Model 100 • 

Model 100, Disk • 

FORMAT 

line# PRINT US IN 

EXAMPLES 

1000 A$="**$tttttt.tttt DOLLARS" define 
string 

1010 PRINT USING A$; TOTAL print check 
DESCRIPTION 

PRINT using is used for displaying special 
formats, primarily dollar amounts and accounting 
values. The string parameter is a literal or variable 
string that defines the format to be used in the 
display. The item list is a list of numeric or string 
variables that define the items to be printed. If 
there is more than one item, all items will be 
printed in the format defined by the string. The 
string uses "field specifiers" to define certain 
formats. A "#" specifies a digit position. A "." is a 
decimal point position and is printed in the position 
specified. A "," is printed in the position specified. 
Asterisks (*) fill unused positions left of the decimal 
with asterisks. "$$" or "**$" indicate a floating 
dollar sign, printed before the number. The string 
"**$###,###.## DOLLARS" used with variable 
A=96654.678 generates *$96,654.68 DOLLARS. 
Other specifiers include up arrows, plus sign, minus 
sign, %spaces%, and exclamation point. 
RELATED COMMANDS LPRINT using 



SYSTEM 




set middle dot to 



I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC • 
CC, Disk • 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

linett PSET (x,y,c) 
linett PSET (x,y) 

EXAMPLES 

1000 pset (i^y,ys,s; 

blue 

DESCRIPTION 

PSET is used to set one graphic element on the 
current graphics page. The x and y parameters 
define the horizontal and vertical element numbers, 
respectively. The x value can range from through 
255; the y value can range from through 191. The 
coordinates specify an element in the highest 
graphics resolution of 256 by 192 elements. The 
actual area set depends upon the current PMODE 
resolution set for graphics. The color parameter, c, 
may be any valid color number of 1 through 8 
(green, yellow, blue, red, buff, cyan, magenta, and 
orange). Again, valid color codes depend upon the 
PMODE mode. The c parameter is optional; if c is 
omitted, the current foreground color is used. If 
SCREEN has specified a text page, no action will 
be seen, but the PSET action has occurred. 
"PSET" is also used in the LINE command, where 
it means "draw the line or box in current 
foreground color" 
RELATED COMMANDS 

LINE, PRESET 



SYSTEM 

I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 

III, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 • 

Model 100, Disk « 

FORMAT 

linett PSET (x,y) 



EXAMPLES 

1000 PSET (120,32 




set middle pixel 



DESCRIPTION 

PSET is used to set one pixel on the screen. The x 
and y parameters define the horizontal and vertical 
element numbers, respectively. The x value can 
range from through 239; the y value can range 
from through 63. PSET can be used at any time, 
even though text characters also occupy the screen. 
Figures are drawn by a succession of properly 
oriented pixels set by PSET and reset by PRESET 
commands. 

RELATED COMMANDS 

PRESET 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk ® 

II, 12 * 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) -» 
4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC 

CC, Disk » : : •' V - 

MC-10 

Model 100 

Model 100, Disk 

FORMAT 

linett PUT butt 
linett PUT buftt.rectt 

EXAMPLES 

1000 PUT 3,100 output imth record 
DESCRIPTION 

PUT is used to output a random-access file record 
to disk. A random-access file allows records to be 
read or written on a random basis (not in 
sequence). The PUT outputs the contents of the 
current record as the next record in sequence or as 
the specified record number of the random file. The 
"current record" is the entire buffer contents if the 
record length defined by the OPEN was 256, or a 
portion of the buffer if the record length was less 
than 256. Prior to the PUT, an OPEN with the "R" 
option must have been executed. The OPEN defines 
the filename and buffer associated with the file, and 
the file length. The PUT buf# form of PUT outputs 
the current record in the buffer as a record whose 
number is one higher than the last access. If no 
record has been written, this becomes the first 
record of the file. The second form of PUT writes 
the current record as the specified record number 
defined by "rec#" 

RELATED COMMANDS 

GET 




SYSTEM 

I, LVL I 
I. LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III. Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 

CC, Ext BASIC • .. 

CC, Disk • ,-...: ■ ,. >; 

MC-10 - C- :-.-:;. -_.- . > '— 

Model 100 — ' ^ 

Model 100, Disk 

FORMAT 

linett PUJ(xl,yl)(x2,y2),array name,action 
EXAMPLES 

1000 PUT 

( 205 , 141 ) - f 255 . 131 ) , flfl , PSET 

DESCRIPTION 

GET stores any rectangular area on a graphics 
screen in a two-dimensional array. A PUT later 
retrieves the graphics data from the array and 
displays it in any other area of the graphics screen. 
GET/PUT can be used to save portions of a 
graphics screen or to create animation effects. The 
xl,yl coordinates define one corner of the screen 
area for the PUT operation; The x2,y2 coordinates 
define the opposing corner. The xl,x2 and yl,y2 
values are in "high-resolution" graphics coordinates 
of 0-255 and 0-191, respectively. The "array name" 
is the name of a two-dimensional array previously 
filled by a GET statement. In general, the PUT area 
must be equal to the dimensions of the GET area. 
The "action" option is PSET, PRESET, AND, 
OR, or NOT. If a "G" option was used in the GET, 
then an action item must be used in the PUT. 
PSET transfer the data in the same way, PRESET 
inverts the colors, and AND, OR, and NOT can be 
used to perform logical operations on the graphics 
data. 

RELATED COMMANDS GET 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4. 4P) ■ 
III, Disk (4, 4P) - 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

line# RANDOM 

EXAMPLES 

1000 RANDOM "reseeds" the random number 
generator for RND 

1010 PRINT RND (100) : GOTO 1010 print 
list of random numbers from 1 to 100 

DESCRIPTION 

RANDOM initializes the random number generator 
for the RND function. The RND function is used to 
generate pseudo-random numbers from to N. 
Pseudo-random numbers are "repeatable" numbers, 
that is, the same sequence of numbers is repeated 
from the same starting number. If RANDOM is never 
used, the same sequence of numbers will be 
generated on system power up or restart. The 
sequence will be quite long, but RANDOM ensures 
that a true random starting point is used for an 
unpredictable sequence of numbers. 

RELATED COMMANDS 

RND 




SYSTEM 

LVL I 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P)< 
I, Disk (4, 4P) < 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 



FORMAT 

//ne# READ variable 1, variable 2, variable 
3,...variable N 

EXAMPLES 

1000 READ A , B , XY reads three numeric values 
1010 READ z% , XX% reads two integer values 
1020 READ A$,B$ reads two strings 

DESCRIPTION 

READ reads a value or values from a DATA list. 
The variables in the READ are set to the next 
values in the DATA list. The variable types in the 
DATA list must correspond to the variable types in 
the READ statement. Variable types in the READ 
statement may be intermixed as long as they appear 
that way in the DATA list. The following statements 
read 5, 13, ORANGE into variables X, Y, and XY$, 
and then read -37, 2, and BANANA into variables A, 
B, and B$. 

1000 DATA 5, 13, ORANGE, -3.7, 2, BANANA 

establishes list 

1010 READ X, Y,XY$ reads first three values 

1020 READ A,B,B$ reads next three values 

RELATED COMMANDS 

DATA, RESTORE 



SYSTEM 

, LVL I » 

, LVL II 

, Disk • 

I, 12 <• 

II, LVL I 

II, LVL III (4, 4P) s 

II, Disk (4, 4P) » 

4, 4P, Disk • 

CC, BASIC • 
CC, Ext BASIC 

CC, Disk o 

MC-10 « 

Model 100 • 

Model 100, Disk • 




FORMAT 

linen REM 

EXAMPLES 

1000 REM THIS PROGRAM SEGMENT IS A 

SORT 

1010 REM IT SORTS TWO-D ARRAY ZZ 

DESCRIPTION 

REM is an abbreviation for "remark'.' The REM 
command may be followed by descriptive text 
defining the program statements. REMarks "text" is 
not executed, but does take up BASIC program 
space. As many REMs as required may be used. 
Delete the REM statements in the final program 
version to save program space and increase 
program execution speed. 



RELATED COMMANDS 



" 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

RENAME "old file" TO "new file" 

EXAMPLES 

RENAME 4i ACCTS/PAY:0" TO 
' 'ACCTS/REC:0" 

DESCRIPTION 

RENAME is a Color Computer Disk BASIC 
command that changes the name of a file. The "old 
file" and "new file" parameters are valid file names; 
both require extensions. File names are in the 
name/extension:drive# format. The drive# is 
optional. RENAME is normally used to rename a file 
on the same disk. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk » 

II, 12 o 

III, LVL I 

Ml, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk » 

CC, BASIC 

CC, Ext BASIC » 

CC, Disk • ' ',- :1: 

MC-10 : ,.-." '.'.-; '--•'.'■--." '•'_ 

Model 100 

Model 100, Disk 

FORMAT 

RENUM newHne,startline,increment (all arguments 
optional) 

EXAMPLES 

RENUM 100,300,5 from line 100 with start of 

300, increment of 5 

DESCRIPTION 

RENUM renumbers the current BASIC program in 
RAM. All line numbers in the program will be 
changed to a new range of numbers, starting with a 
given number, and with a given increment. This 
includes not only statement line numbers at the 
beginning of BASIC lines, but line numbers 
referenced by GOTOs, GOSUBs, THENs, 
ON. . .GOTOs, and ON. . .GOSUBs. The newline 
parameter is the starting line number of the 
program after renumbering. The startline parameter 
is the first line number of the current program from 
which renumbering is to occur. The increment 
parameter is the increment to be used between new 
line numbers. All parameters are optional. Defaults 
are 10 for newline, 10 for increment, and the entire 
program for startline. Commas can be used for 
missing parameters, or RENUM can be used alone. 
RELATED COMMANDS 
None 




SYSTEM 

I, LVL I » 

I. LVL II • 

I, Disk * 

II, 12 

III, LVL I 

III, LVL III (4, 4P)» 
III, Disk (4, 4P) * 
4, 4P, Disk 
CC, BASIC • 

CC, Ext BASIC 
CC, Disk • 

MC-10 • 

Model 100 
Model 100, Disk 

FORMAT 

lineft RESETftyj 



EXAMPLES 

1010 RESET ( , ) reset upper left-hand pixel 

DESCRIPTION 

Model l/lll: RESET is used to reset one graphics 
"pixel" to black. There are 6144 pixels, divided up 
as 128 horizontal elements by 48 vertical elements. 
The RESET command resets one of these pixels to 
"off" Each of the 6144 pixels can be uniquely 
RESET. The x coordinate specifies the horizontal 
position of 0-127. The y coordinate specifies the 
vertical position of 0-47. 

Color Computer, MC-10: RESET is used to reset one 
graphics "pixel'.' There are 2048 pixels, divided up 
into 64 horizontal elements by 32 vertical elements. 
The x coordinate specifies the horizontal position of 
0-63. The y coordinate specifies the vertical position 
of 0-31. The reset turns off the pixel to a black 
color. 

RELATED COMMANDS 

CLS, POINT, SET 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

Ml, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 




FORMAT 

linen RESTORE 

EXAMPLES 

1000 RESTORE resets the pointer to the DRTA 
list 

DESCRIPTION 

RESTORE resets the internal DATA list pointer to 
the beginning of the DATA list. All DATA 
statements scattered throughout a BASIC program 
(or appearing consecutively) create one contiguous 
list of DATA values. RESTORE resets the internal 
DATA list pointer to the first entry in the list so that 
the next READ results in a read of that entry. The 
following statements read 5, -27.5, and 3 into 
variables A, B, C and then into variables D, E, and F. 

.1.000 DATA 5,-27.5,3,5.2,13 establishes 

list 

1010 READ A,B,C read first three values 

1020 RESTORE resets pointer 

1030 READ D,E,F reads first three values 



RELATED COMMANDS data, read 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk • 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P)» 
III, Disk (4, 4P) • 
4, 4P, Disk » 

CC, BASIC 

CC, Ext BASIC 

CC, Disk -■„•■■.: 

MC-10 

Model 100 • 

Model 100, Disk • 

FORMAT 

linett RESUME 

linett RESUME 

linett RESUME linett 

linett RESUME NEXT 

EXAMPLES 

1000 RESUME NEXT resume after error 

DESCRIPTION 

RESUME is the last executed statement of a user 
error-processing routine. A user error processing 
routine is defined by a ON ERRUR GUTU 
command. The error-processing is entered every 
time an error occurs so that the_program may 
investigate the type of error. RESUME is used after 
investigation of the type of error, line number, 
messages, and corrective action, if any. RESUME 
without a line nurnber or with a line number of 
causes the Eifislu interpreter to return to the line 
in which the error occurred. Jhis mode would be 
used after the normal BASIC error action was 
reinstated by an ON ERROR GOTO 0. RESUME 
with a line number causes a branch to the specified 
line number; it is a way of taking further action 
related to the occurrence of the error. RESUME 
NEXT causes a continuation of the program after 
the line in which the error occurred. 
RELATED COMMANDS 

ERL, ERR, ERROR, ON ERROR GOTO 



SYSTEM 

, LVL I 
, LVL II 

, Disk •> 

I, 12 o 

II, LVL I 

II, LVL III (4. 4P) • 

II, Disk (4, 4P) « 

4, 4P, Disk • 

CC, BASIC • 

CC, Ext BASIC • 

CC, Disk • 
MC-10 

Model 100 • 

Model 100, Disk • 




FORMAT 

linett RETURN 

EXAMPLES 

1000 GOSUB 12000 calls subroutine at 12000 
1010 (return point) return point from 12090 

12000 (subroutine: from 1 to many statements) 
12090 RETURN returns to statement after 

GOSUB 

DESCRIPTION 

RETURN defines the last statement in a subroutine. 
A subroutine is a set of 1 to many statements that 
perform a specific function. Rather than writing the 
statements many times in a program, the subroutine 
is used once for the function, saving RAM space. 
The subroutine is called by a GOSUB. The RETURN 
statement of a subroutine returns control to the 
statement immediately following the GOSUB. No line 
number is required for the RETURN as the BASIC 
interpreter automatically records the line number 
after the GOSUB. 

RELATED COMMANDS 

GOSUB, ON... GOSUB 



SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4. 4P) ■ 
II, Disk (4, 4P) ■ 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

line#...RIGHT$(string,n) 

EXAMPLES 

1000 fi$=RIGHT$ ( B$ , 4 ) get the last 4 
characters of B$ 

1010 C$=RIGHT$ ( B$ , 5 ) get the last 5 
characters of B$ 

DESCRIPTION 

RIGHTS finds the last n characters of a given 
string. The n parameter may be to 255. The string 
parameter is a previously defined string. If 
B$="HEROINE',' for example, fi$=RIGHT$(B$,4j 
will set A$="OINE" If n is greater than the length of 
the specified string, RIGHTS will return the entire 
string. fi$=RIGHT$i;B$,20), for example, 
returns A$="HER0INE" The n argument may be a 
constant, variable, or expression. RIGHTS may be 
used to process "substrings" where a large string is 
made up of a number of substrings concatenated 
together for ease of handling. 

RELATED COMMANDS 

LEFTS, MIDS 




SYSTEM 

I, LVL I 

I, LVL II • 

1, Disk * 

II, 12 • 

III, LVL I 
III, LVL III (4, 4P)« 

III, Disk (4, 4P) • 

4, 4P, Disk « 

CC, BASIC • "- , - 

CC, Ext BASIC • --■ : .- f 

CC, Disk « - >. . ,' - 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

//ne#...RND ( ) . . . 

line#...P,m(integer)... 

EXAMPLES 

1000 fl=RND ( 10 ) generates a random number 
from lto 10 

1010 IF R=l THEN PRINT "STfiRSHIP 

MfiLFUNCTluN' ' simulates a chance condition 1 

out of 10 times 

DESCRIPTION 

RND is a function that generates a pseudo-random 

number. If the RND(0) form is used, the number 

is between and less than 1. Typical numbers 

might be .6789 2344..., and 1.2222.... If the 

RND(N) form is used, where N is not 0, then RND 
generates a number from 1 to N. If N were 1000, 
for example, the number generated would range 
from 1 to 1000 and might typically be 23, 999, 456, 

2, 45, etc. Pseudo-random numbers are 
"repeatable" that is, they produce the same 
sequence of numbers from a given starting number. 
A starting number of 23 might always produce the 
sequence 23, 456, 888, for example. Over a long 
period, the numbers in the range tend to be evenly 
distributed; there will be an equal number of Is, 2s, 
3s 4s etc. 

RELATED COMMANDS 

RfiNDOM 



r 



SYSTEM 



I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 

III, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 • 

Model 100, Disk • 

FORMAT 

//7?e#...PND(0)... 
//ne#...RND(lj... 

EXAMPLES 

1000 FFRNDfl' 




generate a random number 



DESCRIPTION 

PND is a function that generates a pseudo-random 
number between and 1. Typical random numbers 
generated are .59521943994623 and 
.765976517722823. Pseudo-random numbers are 
"repeatable", that is, they produce the same 
sequence of numbers from a given starting number. 
Over a long period, the numbers in the range tend 
to be equally distributed. To convert the fractional 
number produced by PNDf 1 ), multiply by a 
constant; 1000*RNDf 1), for example, produces 
numbers between and 1000. To generate integer 
numbers between and another value, use the 
INT function; INT f 1000*RND f 1 ) ] , for 
example, produces non-fractional values between 
and 1000. The RND(O) case repeats the last 
pseudo-random number generated. 

RELATED COMMANDS 

None 




SYSTEM 

LVL I 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

linett ...90U(dummy).. 

EXAMPLES 

1000 R=RON|'0] 



DESCRIPTION 

ROW finds the current row on which the cursor is 
located and returns the row number. Rows on the 
Models 12 and 4 are numbered from through 23. 
The "dummy" parameter is any value enclosed in 
parentheses; it has no effect on the function, row 
is used along with POS to define the cursor position 
for word processing and other applications. 



RELATED COMMANDS 

POS 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) ■ 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//ne# RSET field name=string 

EXAMPLES 

1000 RSET NM$=fi$ store addressee 
name 

DESCRIPTION 

R5ET is used to place character data into a 
random-file buffer. The normal sequence of 
operations establishing a random-file buffer is as 
follows: Define the fields of the buffer by a FIELD 
statement. The FIELD establishes the field names 
in the buffer. The RSET and LSET are then used 
to store character data in the fields of the buffer. 
The FIELD statement establishes the size for each 
buffer field. If the data to be stored by RSET is not 
as great as this field size, "filler spaces" would be 
filled on the left. If the field NM$ was 20 
characters, the name "SPIRO SMITH" would be 
stored as "SPIRO SMITH'.' If data to be stored by 
RSET is greater than the field size, characters are 
truncated on the right. The data 
"SPIRO AGOUPOPOPODOUPOLIS" would be stored as 

"SPIRO agoupopopodoif: 
RELATED COMMANDS 

FIELD, LSET 




SYSTEM 

, LVL I 

, LVL II « 

, Disk o 

I, 12 o 

II, LVL I 

II, LVL III (4. 4P) • 
II, Disk (4, 4P) » 

4, 4P, Disk * 

CC, BASIC » 

CC, Ext BASIC • 

CC, Disk * ;''.-' 

MC-10 o -.- 

Model 100 • 

Model 100, Disk • 

FORMAT 

RUN 

RUN lineif 
linefi RUN 

EXAMPLES 

RUN in command mode starts BASIC program 

from beginning 

RUN 1000 in command mode starts program from 

line 1000 

1000 RUN in program restarts program from 

beginning 

DESCRIPTION 

RUN clears all variables and resets other BfiSIC 
program parameters. RUN in the command mode 
starts the current BASIC program from the 
beginning. The RUN linett form in the command 
mode starts the program from a specified line 
number. Note that all variables are cleared before 
the start occurs. The RUN form within a program 
restarts the program from the beginning (or a 
specified line #); it may be used to restart the 
program on completion of a game or other 
continuous task. 

RELATED COMMANDS GOTO 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

RUN "deviceiilename" 
RUN "device:configuration " 
RUN "device:...",R 

EXAMPLES 

RUN ' ' RAM : SORT1 " , R load and run 

DESCRIPTION 

RUN loads a BASIC program from RAM, CAS, COM, 
MDM, or disk and then immediately executes it. The 
"device" parameter is one of the four mnemonics or 
a disk drive number. The "filename" parameter is 
used for RAM, CAS and disk and is the filename 
under which the file was first saved. If the device is 
RAM or disk, an optional .BA or .CO extension can 
be used as part of the filename. A disk file name 
must include a drive # and colon (0: or 1:) before 
the filename. If the filename is omitted from a CAS 
load, the first file found will be loaded. If the device 
is COM or MDM, a "configuration" string is used in 
lieu of a fliename. This string sets up the 
communications parameters. 

RELATED COMMANDS 

LORD 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk » 

II, 12 • 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) » 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk « 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

RUN "filename" 
RUN "filename'^ 
linett RUN "filename" 
lineti RUN "filename'.'R 
EXAMPLES 

RUN " ACCOUNTS-' BAS:1' ' 
files open 

DESCRIPTION 

RUN loads and executes a BASK 
disk. Variables are not cleared as 
LuAD. If RUN is used without the R option, PUN 
will close all open files, load the specified program, 
and execute it. If PUN is used with the "R" option, 
RUN will will not close open files, and will load and 
execute the BASIC program. RUN in either form 
may be used in a BASIC statement during BASIC 
program execution. The "filename" is a filespec for 
a BASIC program stored on disk; it conforms to 
the general requirements for filespecs - name, 
extension, password, and drive number. RUN may 
be used in BASIC programs to "chain" programs, 
allowing one program to call another in a chain of 
"overlays'.' One program may utilize file variables 
from another program when RUN is used instead of 
LOAD. 

RELATED COMMANDS 

LOAD 



load, keep 



program from 
is the case with 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 

CC, BASIC -.-. *.. .„- :i .' 

CC. Ext BASIC r_.__z rr — .^_ — 

CC, Disk ':V "'-'-- - -•■- -•"'' \.-i r -"-ij', 

Mc-io ■'--- ' v. -;-_*"" " ?-'-\r.\ 

Model 100 • .' ' -— • " - ' '-~^BJ.. 

Model 100, Disk • ' . _ _ _ ___.._-' 

FORMAT 

SAVE "device:filename" 

5A VE "device:configuration " 

SRVE "device:...", A 

EXAMPLES 

SAVE ' ' RAM : SORT1 ' ' , A save /n /ISC// 

DESCRIPTION 

SAVE saves a BASIC program to RAM, CAS, COM, 

MDM, or disk. The "device" parameter is one of the 

four mnemonics or a disk drive number. The 

"filename" parameter is used for RAM, CAS and disk 

and is the filename under which the file is to be 

saved. If the device is RAM or disk, an optional .BA 

or .CO extension can be used as part of the 

filename. A disk filename must be preceded by a 

drive number (0: or 1:). A SAVE to CAS is logically 

equivalent to the CSAVE command. If the device is 

COM or MDM, a "configuration" string is used in 

lieu of a filename. This string sets up the 

communications parameters. The A option saves the 

program in ASCII format, necessary for a following 

MERGE. A SAVE "LPT: " is identical to 

LLIST. A ' 'SAVE ' 'LCD: ' ' is identical to 

LIST. 

RELATED COMMANDS 

LOAD, CSAVE, MERGE 



SYSTEM 




I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

SAVEM "filename','startaddr,endaddr,execaddr 



\&H3000,&H3FFF, 



EXAMPLES 

SAVEM "SORTPR 
&H300O 

DESCRIPTION 

SAVEM is a Color Computer Disk BASIC command 
generally used to save a machine-language program 
in RAM as a disk file. The "filename" parameter is a 
standard Disk BASIC file name in the 
name/extension:drive# format. The extension and 
drive # are optional. If no extension is given, 
BASIC will use the extension "BIN" If no drive# is 
given, the standard DRIVE default will be used. 
SAVEM can be used to save any binary data in 
RAM whether it is a machine-language program, 
data, or both. The startaddr parameter specifies the 
starting address of the data to be saved. The 
endaddr parameter specifies the end of the data. 
The execaddr specifies the address of the start of 
the program, if applicable. The resulting file is 
stored as a binary file and can be loaded and 
executed by the LOADM and EXEC commands. 

RELATED COMMANDS 

EXEC, LOADM 




SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 



FORMAT 

SfiVEM "filename",startaddr, endaddr,execaddr 
fiVEM "CAS:filename",startaddr, endaddr,execaddr 
fiVEM "drive#:filename",startaddr, 

endaddr,execaddr 



50000 , 500J0 , 50000 



EXAMPLES 

SfiVEM "MLPR" 
save ml program 

DESCRIPTION 

SfiVEM saves a machine-language program to 
cassette, or disk. The file can then be loaded by a 
LOfiDM command. The command saves the memory 
block from "startaddr" through "endaddr" with 
starting address "execaddr". The "execaddr" 
parameter is optional; if not given "startaddr" will 
be used as the entry address. The first form of the 
command writes the program to RAM and includes 
the extension CO. The SfiVEM "CAS:filename" form 
is logically equivalent to CSfiVEM. The disk file 
form saves the machine-language file to disk (drive# 
is 0: or 1:). 

RELATED COMMANDS 

LOfiDM, CSfiVEM 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//ne# SCREEN type, color set 




EXAMPLES 

1000 SCREEr 



, 1 set text, color set 1 



DESCRIPTION 

SCREEN is used to set the type of display, graphics 
or text, and to select one of the two color sets 
available in the Color Computer. The type parameter 
is either a for a text screen, or a 1 for graphics 
screen. If a text screen is selected, the text screen 
starting at location $400 is displayed. This is the 
"normal" text display mode used to display 
alphanumeric data. If the graphics mode is selected, 
the current graphics page is displayed in the 
current graphics resolution. The current graphics 
resolution and page are determined by the PMODE 
command. The "color set" parameter selects one of 
two color sets. In the text mode, color set is black 
on green and color set 1 is red on orange. In the 
graphics mode, the colors depend upon the color 
set and resolution. (See PMODE.) 

RELATED COMMANDS 

PMODE 



SYSTEM 

I. LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (MP) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

SCREEN 0,0 or SCREEN 1,0 
SCREEN 0,1 or SCREEN 1,1 
Hnett SCREEN N,M 




EXAMPLES 

1000 SCREEN 0,0 



scroll with all 8 lines 



DESCRIPTION 

The SCREEN command enables or disables the 
Function Key line on the bottom of the screen. 
When the SCREEN 0,1 command is executed, the 
bottom line can be used for displaying test and 
graphics produced by PRINT and other commands, 
and will "scroll" together with the seven lines 
preceding. If SCREEN 0,1 is never executed or if 
SCREEN 0,0 is executed after a SCREEN 0,1, 
the bottom line will not be available for scrolling 
and only the top seven lines will scroll. Disk 
BfiSIC: SCREEN 1,0 or 1,1 enables the crt 
display and controls the Function Key line. 

RELATED COMMANDS 

PRINT 




SYSTEM 

I, LVL I • 

I, LVL II 

I, Disk a 

II, 12 

III, LVL I 

III, LVL III (4. 4P) • 
III, Disk (4, 4P) * 

4, 4P, Disk ___ 

CC, BASIC • 

CC, Ext BASIC • ' .~ r - -c~~ tht. ,- -~ - - ^ 

CC, Disk • 

MC-10 

Model 100 , =_ Mi; - - - . '' ' JM 

Model 100, Disk < 

FORMAT 

linen SEJ(x,y) Model l/lll 
linen sET(Xy,cj Color Computer 
EXAMPLES 

1000 SET ( RND ( 127 j , RND f 47 ] ] set random 
point l/lll 

1010 SET ( RND f" 63 I, RND (31 
random point to blue (CC) 

DESCRIPTION 

Model l/lll: SET is used to set one graphics "pixel" 
to white. There are 6144 pixels, divided up as 128 
horizontal elements by 48 vertical elements. Each of 
the 6144 pixels can be uniquely SET. The x 
coordinate specifies the horizontal position of 0-127. 
The y specifies the vertical position of 0-47. 
Color Computer, MC-10: SET is used to set one 
graphics "pixel" to a specified color, c. There are 
2048 pixels, divided up into 64 horizontal elements 
by 32 vertical elements. The x coordinate specifies 
the horizontal position of 0-63. The y coordinate 
specifies the vertical position of 0-31. The c 
parameter is a color code of through 8 (black, 
green, yellow, blue, red, buff, cyan, magenta, 
orange). 

RELATED COMMANDS 

CIS, POINT, RESET 



1 set 




SYSTEM 

I, LVL I 

I, LVL II * 

I, Disk o 

II, 12 

III, LVL I 

III, LVL III (4, 4P)» 
III, Disk (4, 4P) » 
4, 4P, Disk » 

CC, BASIC * 

CC, Ext BASIC • ..;.-'•-.;.. 

CC, Disk » ; ; 

MC-10 • 

Model 100 • 

Model 100, Disk « 

FORMAT 

line#...SGH(expression)... 

EXAMPLES 

1000 IF 5GN(X)=0 GOTO 2000 ELSE IF 
SGN(X)=1 GOTO 3000 ELSE GOTO 4000 
goto 2000 // X=id , 3000 if X positive, or 4000 if 
X negative 

DESCRIPTION 

SGN is a sign function. It finds the sense of a 
constant, variable, or expression. The argument 
must be enclosed within parentheses. If the 
argument is negative, SGN returns a -1; if the 
argument is 0, SGN returns a 0; if the argument is 
positive, SGN returns a +1. SGN is a convenient 
replacement for code such as: 

1000 IF X<0 THEN fi=-l 
1010 IF X=0 THEN fl=0 
1020 IF X>0 THEN R=+l 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4.4P)' 
III, Disk (4, 4P) - 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk < 




FORMAT 

line#...S I U(expression)... 

EXAMPLES 

1000 C=SIN(Z+3. 14159/2 j sets variable C 
equal to sine of X+pi/2 (in radians) 
2000 ND=S IN (X*. 01745329) sets variable 
ND equal to sine of X (in degrees) 

DESCRIPTION 

SIN finds the sine of a given constant, variable, or 
expression. The quantity is assumed to be in radians 
(180/pi degrees). SIN is a "function" and may be 
used anywhere within a EiRSIC statement as long 
as the argument is enclosed within parentheses. 
Multiply by .01745329 to convert degrees to 
radians. Standard trigonometric rules apply in 
regard to the sign of the result. 

RELATED COMMANDS 

None 



SYSTEM 

LVLI 

LVLII 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

SKIPF 

SKIPF "filename" 

EXAMPLES 

SKIPF "MVPROG' 



skip over MVPROG 



DESCRIPTION 

SKIPF is used to skip over an indicated file on 
cassette. Executing SKIPF with a filename will 
cause BfiSIC to search for the file name and 
position the tape after the end of file. It is therefore 
positioned to read the next file after "filename" 
Executing SKIPF without a filename will cause 
BRSIC to skip the next file on cassette and 
position the tape after the end of the file, ready to 
read the next file. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVLII 

I, Disk 

II, 12 

III, LVLI 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

lineti SOUND freq,duration 

EXAMPLES 

1000 FOR 1=1 TO 255 set frequency loop 
1010 SOUND 1,2 output tone 
1020 NEXT I loop 

DESCRIPTION 

SOUND outputs a tone to the TV speaker. The 
frequency of the tone is specified by a "freq" count 
of 1 to 255. Middle C corresponds roughly to a 
count of 89. The remaining counts range roughly 
over four octaves; the lower the count, the lower the 
note. The frequency count is "linear"; a count of 
1/2 the value of another count is 1/2 the 
frequency. The duration value of 1 through 255 
determines the duration of the tone. Each count is 
roughly l/16th of a second, making the range of 
durations l/16th second to 16 seconds. SOUND 
can be used to output warning tones or to play 
musical notes in songs or games. 

RELATED COMMANDS 

PLRY 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 
ill, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 

CC, BASIC — "- "*--■-- - -_-:, 
CC. Ext BASIC .' --— — "-^ v n— >~ 7 T I 
CC, Disk , - * •••.,..' 

MC-10 ;~- -->-•-"--- ^_ :-.;,-, 
Model 100 • ^^- — ■ 

Model 100, Disk • { 

FORMAT 

SOUND ON 

SOUND OFF 

linett SOUND freq, duration 

EXAMPLES 

1000 FOR 1=1 TO 255 set frequency loop 
1010 SOUND 1 , 2 output tone 
1020 NEXT I loop 
DESCRIPTION 

SOUND outputs a tone to the speaker. The 
frequency of the tone is specified by a "freq" count 
of to 16383. The counts range over approximately 
five octaves; the greater the count, the lower the 
pitch. The frequency count is "linear"; a count of 
twice the value of another count is half the 
frequency. The duration value of through 255 
determines the duration of the tone. Each 50 counts 
is equal to about five seconds. SOUND can be used 
to play musical notes in songs or games or as 
warning tones. SOUND ON and SOUND OFF is a 
special command that enables or disables the beep 
on cassette loading or data communications. The 
beep is enabled unless a SOUND OFF is used. 
RELATED COMMANDS 
None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//ne# ... SPACE ^(expression)... 

EXAMPLES 

1000 A$= ' ' NAME ' ' +SPACES f 23 "I 
+ ' 'ADDRESS" 

DESCRIPTION 

SPACES returns a string of spaces. It is logically 
equivalent to STRING$(" ",n), where n is the 
number of characters to return. The constant, 
variable, or expression for SPACES must be a 
numeric value from through 255. Spaces (blanks) 
are commonly used in PRINT or LPRINTing 
reports and other text processing. SPACES 
provides a convenient way of generating spaces. 

RELATED COMMANDS 

STRINGS 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//'/?e# ...SPC(expmssion).. 




EXAMPLES 

1000 PRINT 
' 'ADDRESS' 



-JANE' 



3PU f 2: 



DESCRIPTION 

5PC prints a line of blanks or spaces. SPi 



does 



not use string space. The expression parameter 
must be a numeric value from through 255. The 
left parentheses must immediately follow the SPC 
characters. SPC is similar to SPACES and can be 
used with PRINT, L.PRINT, and PR I NTH to 
generate spaces or blanks whenever required. 

RELATED COMMANDS 

SPACES 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk « 




FORMAT 

lineti. . . S Q R(expression). . . 



EXAMPLES 

1000 C=SQR[A- 
triangle side 



'■ft + B#B) find length of 



DESCRIPTION 

SQR is the square root function. It returns the 
square root of a constant, variable, or expression 
argument. It can be used anywhere within a 
BASIC statement as long as the argument is 
enclosed in parentheses. It is faster than finding the 
1/2 power of an argument and should be used in 
place of this method. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4,4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

linett STOP 



EXAMPLES 

1000 PEN STOP HERE TO LOOK AT 
VRRIfiBLE I 
1010 STOP 

DESCRIPTION 

STOP is used to temporarily stop BASIC program 
execution. The program may be restarted at the 
STOP point by the CONT (continue) command. 
STOP is normally used during program debugging 
so that intermediate results may be investigated. It 
is also used as a "breakpoint" to determine if a 
certain portion of the program is executed. 
Execution of STOP produces a "BREAK RT (IN) 
XXXXX" message, where XXXXX is the line number. 
After the stop occurs, variables may be examined by 
the PRINT or other commands; all intermediate 
results are left intact. 

RELATED COMMANDS 

CONT 



SYSTEM 

LVL I 

LVL II 

Disk 

, 12 

I. LVL I 

I, LVL III (4, 4P) ■ 
I, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk ■ 




FORMAT 

//7?e#. . . S T R $ (expression). . . 
EXAMPLES 

1000 R$=STR$ ( X ) convert X to a string 
2000 PRINT STR$fXj print X as a string 

DESCRIPTION 

STR$ converts a numeric constant, variable, or 
expression to a string. The argument must be within 
parentheses. In the example above, if X is equal to 
-34.678, it is converted to the seven-byte ASCII 
character string of A$="-34.678". If X is equal to 
34.678, it is converted to the seven byte ASCII 
string of A$=" 34.678" with a leading blank for the 
missing sign. STR$ is used for certain printing or 
string concatenation functions. The converted value 
does not have a trailing blank on printing as a 
numeric value would. Leading zeroes in the numeric 
value are ignored. A byte is always allocated for the 
sign and a minus sign or blank is used. An ASCII 
decimal point is generated in the proper place. The 
number of fractional characters is somewhat 
unpredictable and depends upon the value of the 
expression; trailing zeroes are not generated. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk 8 

II, 12 ° 

III, LVL I 

III, LVL III (4, 4P)* 
III, Disk (4, 4P) » 
4, 4P, Disk « 

CC, BASIC • 

CC, Ext BASIC • ; . , . ? !i / . . li 

CC, Disk • '" ".'--.. ;S - .""' 

Mc-io .J-.-.- ..yz: 

Model 100 • < 

Model 100, Disk • 

FORMAT 

linett STRING$(n,"char") 
lineti STRms$(n,value) 

EXAMPLES 

1000 R$=STRING$f 100, "A' ' ) create 

A$="AAAAAA...A" 

1010 B$=STRING$(50,23] create 

B$=CHR5(23)+CHR'$(23)..+CHR$(23) 

DESCRIPTION 

STRINGS is used to create a 1 to 255 character 
string made up of the same character. The n 
parameter is the number of characters in the string, 
from to 255. It may also be a variable or 
expression that resolves to to 255. The "char" 
parameter is a single ASCII character that defines 
the characters in the string. Alternatively, a value of 
to 255 may be used in place of "char'.' In the 
latter case, the equivalent string will be made up of 
n characters of that value (equivalent to 
CHR$(value)+CHR$(value)+. ..). STRINGS is used 
to create strings made up of the same character for 
screen graphics use, borders, filling dummy data, or 
other uses. 

RELATED COMMANDS 

None 



SYSTEM 

, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

lineff SWAP variablel,variable2 



EXAMPLES 

1000 SWAP A,B 



swap variables 



DESCRIPTION 

SWAP swaps the values of two variables. The 
variables must have been previously defined (had 
values assigned to them). Either or both of the 
variables may be array variables. The variable types 
of both variables must be the same. SWAP can be 
used in place of code such as "1000 C=A: A=B: 
B=C". 

RELATED COMMANDS 

None 




SYSTEM 

LVL I 

LVL II • 

Disk • 

, 12 
I, LVL I 

I, LVL III (4,4P)» 
I, Disk (4, 4P) » 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

SYSTEM 

EXAMPLES 

SYSTEM enter system mode 

DESCRIPTION 

SYSTEM puts BASIC into the System mode. This 
is a mode in which machine-language tiles can be 
loaded from cassette tape. After SYSTEM is 
executed, the BfiSIC interpreter will respond with 
the prompt *?. To load a machine-language 
program from cassette, position the cassette, and 
type in the cassette file name, followed by ENTER. 
BASIC will now load the cassette file, flashing 
asterisks as it does so. After the load, another *? 
prompt will be displayed. Another machine-language 
program can now be loaded or control transferred to 
the machine-language program. In the latter case, 
type a slash (/) followed by the decimal address for 
execution, followed by ENTER. If no address is 
entered after the slash, control will be transferred to 
the starting address of the file from cassette. (You 
do not have to know the starting address for a 
typical cassette load.) 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III. LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk • 

CC, BASIC . ^- - ra,, . -7~ -' 

CC, Ext BASIC --- -- -. - 

CC, Disk ;**---• ■ . - V*" 1 /'"' ' ,1 l 

MC-10 

Model 100 '". -•-.-. -A- ~'^^:xz 

Model 100, Disk ( 

FORMAT 

SYSTEM 

SYSTEM "command" 

EXAMPLES 

SYSTEM return to TRSDOS 

DESCRIPTION 

SYSTEM causes an exit from BASIC and a return 
to TRSDOS. If there is no command, the operation is 
complete. If there is a TRSDOS command, the 
command is executed and a return made back to 
BASIC. The command must be enclosed in quotes, 
unless it is a string expression. If the command 
involves loading and executing a TRSDOS utility 
program that involves high memory and 
"overlay" of BASIC, return will not be made to 
BASIC. SYSTEM allows a BASIC program to 
execute a TRSDOS command within the program 
and then return back to the program. 1000 
SYSTEM ' *DIR' ', for example, would exit 
BASIC, boot TRSDOS, perform a directory listing, 
and then return to the next statement after the 
SYSTEM command. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I • 

I, LVL II 

I, Disk e 

II, 12 

III, LVL I ° 
III, LVL III (4, 4P)« 
III, Disk (4, 4P) » 
4, 4P, Disk « 
CC, BASIC • 
CC, Ext BASIC • 
CC, Disk • 
MC-10 • 
Model 100 • 
Model 100, Disk « 

FORMAT 

line#...Tf\B(expression)... 

EXAMPLES 

1000 PRINT ThB (25 ) "BALANCE OFF ! " 
DESCRIPTION 

TAB is a special function used with PRINT or 
LPRINT to "tab over" to a given tab position. The 
"expression" in TAB must be between and 255. 
It may be a constant, variable, or expression. The 
value defines the tab position. When used with 
PRINT, the cursor is moved to the right to this tab 
position, and any remaining print items are printed 
from that point. Valid tab positions for the Model 
l/lll are to 63, for the Models II, 12, and 4 are 
to 79, for the Color Computer are to 31, and for 
the Model 100 are to 39. Values above these will 
be "modulo" 64, 80, 32, or 40, respectively. When 
used with LPRINT, the line printer outputs the 
number of spaces required to effect the tab. TAB 
cannot move the cursor or line printer print position 
to the left. If the tab point has already been 
reached or exceeded, the TAB is ignored. 

RELATED COMMANDS 

LPRINT, PRINT 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk « 

II, 12 

III, LVL I 

III, LVL III (4, 4P)* 

III, Disk (4 t 4P) * 

4, 4P, Disk • 
CC, BASIC 1 

CC, Ext BASIC » li 

CC, Disk • It 

MC-10 • 

Model 100 • i— 

Model 100, Disk * l-^. 

FORMAT 

linett. . . T A H(expression). . . 



EXAMPLES 

1000 A=TAN('Y+3. 14159/2] sets variable A 
equal to tangent of Y+pi/2 (in radians) 
2000 ND=TAN(X*. 01745329] sets variable 
ND equal to tangent of X (in degrees) 

DESCRIPTION 

TAN finds the tangent of a given constant, variable, 
or expression. The quantity is assumed to be in 
radians (180/pi degrees). TAN is a "function" and 
may be used anywhere within a BASIC statement 
as long as the argument is enclosed within 
parentheses. Multiply by .01745329 to convert 
degrees to radians. Standard trigonometric rules 
apply in regard to the sign of the result. 

RELATED COMMANDS 

ATN 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk * 

II, 12 » 

III, LVL I 

III, LVL III (4, 4P)« 
III, Disk (4, 4P) • 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 • 

Model 100, Disk • 

FORMAT 

linen ...TIMES. . 

EXAMPLES 

1000 PRINT 

DESCRIPTION 

TIMES returns the current time as a text string. 
When TRSDOS is started up, the operator may enter 
the current time. TIMES returns this information in 
BASIC. The format of the Model II and 12 TIMES 
string is HH.MM.SS where HH is the hours, MM is 
the minutes, and SS is the seconds. The format of 
the Model l/lll TIMES string is DD/MM/YY 
HH:MM:SS, where the date is also included. The 
format of the Models 4 and 100 TIMES string 
is HH:MM:SS. 

RELATED COMMANDS 

None 



'TIME r 



TIMES 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 

Model 100 • 

Model 100, Disk • 

FORMAT 

linen TIMES ON 
linen TIMES OFF 
linen TIMES STOP 

EXAMPLES 

1000 TIMES ON 

DESCRIPTION 

ON TIMES GOSUB defines an interrupt to the 
system for a specific time of day. The interrupt will 
occur and the interrupt processing subroutine will 
be entered provided that a TIMES ON command 
has been executed sometime before the time of day 
occurs. TIMES OFF "disables" the time of day 
interrupt so that even if the time of day occurs at 
the time defined in the ON TIMES GOSUB 
statement, the interrupt will be ignored. The TIMES 
STOP "remembers" the interrupt but allows the 
program to ignore it until the next TIMES ON, at 
which point the interrupt subroutine is immediately 
entered. 

RELATED COMMANDS 

ON TIMES GOSUB 



eraWeTIMES interrupt 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

linett... TIMER... 
linett TIMER=i/a/ue 

EXAMPLES 

1000 TIMER=60 set timer to 12:01 

1010 PRINT INTi;TIf1ER/60) print elapsed 

time in seconds 

DESCRIPTION 

TIMER is used to control a built-in "real-time 
clock" in the Color Computer. The realtime clock 
increments by one every l/60th of a second. It 
counts from through 65,535, at which point it 
"recycles" back to and begins the counting 
sequence over again. TIMER can be set to any 
value by the TIMER=value command; the value 
represents the starting time in 60ths of a second. 
After TIMER is set, "reading" TIMER will 
represent the elapsed time in 60ths of a second, 
modulo 60. The maximum elapsed time for TIMER 
is 65,535/60, or about 1092 seconds (18.2 
minutes), however, TIMER can be used to control 
variables that represent any elapsed time by 
maintaining more precision. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

TROFE 
linett TROFF 

EXAMPLES 

TROFF turn trace off in command mode 

DESCRIPTION 

TROFF turns off the Trace function previously 
turned off by a TRON command. TROFF is the 
default condition after BASIC has been initialized. 

RELATED COMMANDS 

TRON 



SYSTEM 

, LVLI 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P)< 
II, Disk (4, 4P) < 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk 




FORMAT 

TRON 
linett TRON 

EXAMPLES 

1000 TRON turn line trace on 
3000 TROFF turn line trace off 

DESCRIPTION 

TRON turns on the BRSIC line Trace function. The 
Trace function executes the program as in normal 
execution but displays each line number as it is 
executed within brackets. This trace is useful in 
following the program flow during program 
debugging. The SHIFT and @ keys can be pressed 
simultaneously at any time to stop the display for 
scrutiny. Pressing any key will restart program 
execution. Normal display data generated by 
PRINT or other commands will be interspersed 
with the Trace line numbers. 

RELATED COMMANDS 

TROFF 



SYSTEM 



I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

UNLOAD 
UNLOAD driven 

EXAMPLES 

UNLOAD 1 close all open files 

DESCRIPTION 

UNLOAD is a Color Computer Disk BASIC 
command that is a "blanket" CLOSE. It closes all 
open files for the specified disk drive number. If no 
disk drive number is specified, UNLOAD closes all 
open files in the default disk drive (the one 
specified in the last DRIVE command, or drive if 
no DRIVE command was ever executed). UNLOAD 
is primarily used when switching diskettes. The 
UNLOAD properly closes all open files. Failure to 
properly CLOSE a disk file may result in loss of all 
or a portion of the file data on the old or new 
diskette. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 

I, LVL II • 

I, Disk s 

II, 12 « 

III, LVL I 

III, LVL III (4, 4P) a 
III, Disk (4, 4P) « 
4, 4P, Disk 

CC, BASIC e j—T^.-^^^tV--:-^:-^^;, 

CC, Ext BASIC « .-;;--' ,: "■■ • ._?•; 

CC, Disk • - - -•■;., 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

line#...USR(expression)... 
EXAMPLES 

1000 fi=uSR ( B ) call machine-language routine 

DESCRIPTION 

USR is a function that allows a BASIC program to 
call a machine-language subroutine. The machine- 
language subroutine must have been previously 
loaded into memory and its starting location defined 
by a special sequence. In the Model l/lll this 
sequence is to POKE the least significant byte of 
the start address into location 16526 and the most 
significant byte of the address into location 16527. 
In the Color Computer the starting address is 
POKEd into locations 275 (msb) and 276 (Isb). 
Thereafter, a USR call will cause the BASIC 
interpreter to transfer control to the code at the 
machine-language subroutine. The machine-language 
subroutine will normally return back to the 
statement following USR. The expression parameter 
is a constant, variable, or expression that can be 
resolved down to an integer number. The 16-bit 
value is passed to the machine-language subroutine 
under certain conditions. The machine-language 
subroutine may also return a 16-bit integer value. 
RELATED COMMANDS 

USRn 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk ® 

II, 12 • 

III, LVL I 

III, LVL 111(4, 4P) 
III, Disk (4, 4P) a 
4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC 

CC, Disk « 

MC-10 

Model 100 

Model 100, Disk s 

FORMAT 

line#...USRn(expression)... 
EXAMPLES 

1000 R=USR3 ( B ) call machine-language 
routine 

DESCRIPTION 

USRn is a function that allows a BASIC program 
to call up to 10 machine-language subroutines. The 
machine-language subroutine must have been 
previously loaded into memory and its starting 
location defined by a DEFUSRn. The n parameter 
in the USRn command matches the n parameter in 
the DEFUSR command. DEFUSR5, for example, 
calls the machine-language subroutine defined by 
DEFUSR5. A USRn call will cause the BASIC 
interpreter to transfer control to the code at the 
machine-language subroutine. The machine-language 
subroutine will normally return back to the 
statement following the USR. The expression 
parameter is a constant, variable, or expression that 
can be resolved down to an integer number. The 
16-bit value is passed to the machine-language 
subroutine under certain conditions. The machine- 
language subroutine may also return a 16-bit integer 
value. 

RELATED COMMANDS 

DEFUSR 




SYSTEM 

I, LVL I 

I, LVL II o 

I, Disk 8 

II, 12 « 

III, LVL I 

III, LVL III (4. 4P) • 
III, Disk (4, 4P) • 
4, 4P, Disk • 

CC, BASIC • - 

CC, Ext BASIC • ; , v ai • .-.-\, 

CC, Disk • : . -_-'- 

MC-io • l__r:--.^. -- _.'-:; 

Model 100 • 

Model 100, Disk • 

FORMAT 

Hne#...\fttL(string)... 

EXAMPLES 

1000 fl=VflLf PAYABLES) convert to numeric 
DESCRIPTION 

The VAL function converts a string, assumed to be 
a string representing a number, to a numeric value. 
Typical strings that could be used with VflL are 
"123.56',' "000100" and "999.9E-34" Often, strings 
that primarily contain numeric data may be 
represented in string form for input and output 
operations. VflL provides a way to convert these 
strings to numeric form for efficient processing. 
VflL follows these rules in conversion: If the string 
contains no numeric characters or is null, VflL 
returns a 0. If the string contains all numeric 
characters, VflL converts the string to an integer if 
possible, or to a single-precision number, or to a 
double-precision number. If the string contains a 
decimal point, VflL converts the string to a single-or 
double-precision number. (The Color Computer has 
only one numeric data type.) VflL ignores 
alphabetic characters that do not have significance 
or which it cannot interpret. VflL performs the 
inverse of the SIRS function. 
RELATED COMMANDS 
flSC. CHR$, STR$ 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//'ne#... VARPTR(VariaWe name)... 

EXAMPLES 

1000 B=VflRPTR ( A3 ] get location of A$ 

DESCRIPTION 

VflRPTR is a function that finds the address of any 
BASIC variable. It is primarily used for 
"parameter" passing to machine-language 
subroutines called by the USR or USRn commands. 
If the variable in question is a string variable, 
VflRPTR returns the location of a string parameter 
block. The first byte of the parameter block is the 
string length, and the second and third (third and 
fourth in Color Computer) are the location of the 
string. If the variable is a numeric variable, 
VflRPTR returns either the location (Models l/lll) 
or a pointer to the value (Color Computer or MC-10). 
VflRPTR will also return the location of arrays. 
Model 4 only: When used with a buffer number, the 
address of the buffer is returned. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




FORMAT 

VERIP 
VERIP 



ON 
OFF 



EXAMPLES 

VERIFY ON 



verify disk writes 



DESCRIPTION 

VERIFY is a Color Computer Disk BASIC 
command that turns ON or OFF disk record 
verification. Records are written out to disk from the 
disk buffer specified in the OPEN command; a 
buffer represents one sector's worth of data. When 
VERIFY is ON, the sector just written is read in to 
a second buffer and compared with the original 
data. When VERIFY is OFF, this compare is not 
done. The verification process is a safeguard against 
disk I/O errors, but does increase the "overhead" 
for disk writes. Invalid data will normally be 
detected on a read, but verification provides 
detection during the write operation. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk • 

CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

//'r?e# WRIT portjntegerl 

linett WRIT portjntegerl, integer2 

EXAMPLES 

1000 WRIT 62 , &HF , &H5 test external device 
DESCRIPTION 

WRIT is used to test the status of an external 
signal that comes in to one of the 256 input/output 
ports on the system. Some of these ports are 
dedicated to system input/output functions that 
take place internally in the system. Other ports may 
be used for external input/output device 
"controllers". WRIT will perform a similar action to 
the INP function, reading in the value form the 
specified port address. It will then exclusive OR the 
8-bit value read in with integer2 (or if integer2 is 
not specified) and then and the result with 
integerl. If the result is zero, the WRIT is again 
executed. If the result is non-zero, the next 
statement after the WRIT will be executed. 
Effectively, WRIT will test from one to eight 
input/output lines for either a zero or one. 

RELATED COMMANDS 

None 



WHI LE . 
WEND 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III. LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC I A 

CC, Disk IM 

MC-10 f« 

Model 100 f — 

Model 100, Disk *<-« 

FORMAT 

//'ne# WHILE expression 



WEND 

EXAMPLES 

1000 WHILE H<10 

1010 PRINT A: A=A+1 
1020 WEND 

DESCRIPTION 

WHILE is used in conjunction with a following 
WEND command. Taken together, the BASIC 
statements from WHILE through WEND constitute a 
loop commonly used in more "structured" code. 
This loop is executed continually as long as the 
condition specified after the WHILE in "expression" 
is met. Typically, relational expressions such as 
A<2, B>C*3.14159, and K1000 are used for the 
WHILE condition, but logical expressions can also 
be used; the logical expression is either true (non- 
zero) or false (zero). As in other BASIC loops, the 
WHILE-'WEND loops can be nested to any level. 
WHILE/ WEND loops can also be interspersed and 
nested with other types of loops, such as 

FOR... TO/NEXT. 

RELATED COMMANDS None 



SYSTEM 



WIDTH 



l&~^ -^5-_ >*^uS5vJ-i>ll t ; , ' 'r 4*\ j, ». 



I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 

FORMAT 

WIDTH 40 
WIDTH 80 

EXAMPLES 

WIDTH 40 



DESCRIPTION 

WIDTH sets the width of the crt or television 
screen to either 40 or 80 characters. This width will 
remain in force in all other system programs as well. 
Use SCREEN to display on the crt. 

RELATED COMMANDS 

SCREEN 



SYSTEM 

I, LVL I 
!, LVL II 

I, Disk 

II, 12 

III, LVL I 

III. LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk • 

CC, BASIC 

CC, Ext BASIC I 

CC, Disk • I 

MC-10 # 

Model 100 f- 

Model 100, Disk U 

FORMAT 

linen WRITE item list 



EXAMPLES 

1000 WRITE fl.B,C,D 




print values 



DESCRIPTION 

WRITE is similar to PRINT; it displays a series of 
items. The "item list" in WRITE can be any 
variable type normally used in PRINT statements. 
However, WRITE automatically inserts commas 
between items as they are displayed and places 
quotation marks around strings that are displayed. 
Positive values are displayed without leading blanks, 
unlike PRINT. WRITE is useful for displaying 
lists of values without extensive "formatting" in 
PRINT statements. 

RELATED COMMANDS 

PRINT 



WRITEtt 



iSI 



TFOPorx 

, v i- "I'll- 'i /( " i 



3QiQ| 



SYSTEM 

LVL I 

LVL II 

Disk 

, 12 

I, LVL I 

I, LVL III (4, 4P) 
I, Disk (4, 4P) 
4, 4P, Disk « 

CC, BASIC 
CC, Ext BASIC 
CC, Disk « 

MC-10 
Model 100 
Model 100, Disk 

FORMAT 

line^ WRITE#buf#,/'fem list 

EXAMPLES 

1000 WRITEB3,fl;B;C$ output to file 

DESCRIPTION 

WRITES performs a write to a sequential disk file. 
The file must have been previously OPENed. The 
OPEN command specifies a buffer for the filename, 
and this buffer number is used in the writes 
command. WRITES outputs a list of items to the 
buffer (to the file). The items may be any number of 
numeric or string variables. All items are 
transformed into character strings and written to the 
disk buffer. The WRITES output to the file is 
similar to the display output of PRINT and the disk 
operation of PRINTS. However, WRITES 
compresses data items by eliminating spaces. It 
should be used in preference to the PRINTS. 
String variables should use CHR$(34) to bracket 
the variables with double quotes if the string 
variables contain delimiters such as commas or 
semicolons; otherwise string variables can be used 
in the list as required. 

RELATED COMMANDS 

None 



SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

//'ne# WRITEB bufferjtem list 

EXAMPLES 

1000 WRITE82, H,B,C,D$ 




output list 



DESCRIPTION 

WRITE8 is similar to PRINTB; it writes a series of 
data items in the "item list" to the disk file 
associated with a buffer number. The buffer number 
is the same as the one used in the initial OPEN 
statement for the disk file. Like WRITE for display, 
commas are automatically inserted between data 
items, string data is automatically bracketed by 
quotation marks, and positive numerical values have 
no leading blanks. WRITEtt is a more space 
efficient command to use for disk file data than 
PRINTB. 

RELATED COMMANDS 

PRINTB, WRITE 




SYSTEM 

I, LVL I 
, LVL II 
, Disk 

I, 12 

II, LVL I 

II, LVL III (4, 4P) 
II, Disk (4, 4P) 

4, 4P, Disk 

CC, BASIC 

CC, Ext BASIC 

CC, Disk 

MC-10 

Model 100 

Model 100, Disk • 



FORMAT 

linett... (expression) XuR (expression)... 

EXAMPLES 

1000 IE ((H<29) XOR (B>5)) THEN C=l 

DESCRIPTION 

XUR is used as a relational operator and for bit 
manipulation. In the first use, XOR compares two 
constants, variables, or expressions. If either 
expression is true, but not both are true, then the 
XOR function is true. In the example above, the 
expression is true if variable A is less than 2 OR 
variable B is greater than 5. The THEN action 
would be taken if either expression, but not both 
was true (expression 1 XOR expression 2). In the 
bit manipulation case, XOR is used to logically XOR 
integer variable bits, considered to be binary 
numbers. An XOR of binary values produces a 1 for 
each bit position if either operand but not both has 
a 1 bit in that bit position. An XOR of the two 
binary values 10100000 and 11001111 would 
produce a result of 01101111. The XOR in this 
application can be used to test bits, set individual 
bits, and perform other bit-wise operations. 

RELATED COMMANDS 

AND, NOT 



SYSTEM 

, LVL I • 

, LVL II • 

, Disk 8 

I, 12 • 

II, LVL I • 
II, LVL III (4, 4P) • 
II, Disk (4, 4P) • 

4, 4P, Disk • 
CC, BASIC 

CC, Ext BASIC • 

CC, Disk • 

MC-10 • 

Model 100 • 

Model 100, Disk • 

FORMAT 

lineti ..A(expression).. 

EXAMPLES 

1000 T=(i+ntY 




find amount over Y years 



DESCRIPTION 

Up arrow is used to represent exponentiation, 
raising a number to a power. The power may be a 
constant, variable, or expression. Fractional powers 
are permitted. In some systems the up arrow prints 
as a left bracket. The Model II up arrow is SHIFT,6. 
The Model 4 up arrow is a caret A produced by 
pressing CLEAR followed by " ; ' ' . The Model 
100 up arrow is also a caret. 

RELATED COMMANDS 

None 




SYSTEM 

I, LVL I 
I, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 4P) 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 



FORMAT 

linett ...expression \ expression... 

EXAMPLES 

1000 C=A\B 

DESCRIPTION 

Reverse slash (CTRL,9 on the Model II, 12; CLEAR, 
/ on the Model 4; and GRPH, - on the Model 
100) is a numeric operator that performs an 
"integer division" on two operands and returns a 
result. The two expressions involved are converted 
to two integer operands. An integer division 
operation divides the first operand by the second 
operand and finds the quotient. Any fractional part 
of the quotient is ignored and the integer portion is 
then returned as the result of the operation. If the 
first operand is 100, and the second is 44, the 
result of 100 \44 is the integer portion of 
100/44, or 2. This integer division is similar to the 
INT function except that the two operands here 
must be in the range of -32768 through +32767. 

RELATED COMMANDS 

INT 



Special Keys for BASIC 



Key 



Description 



.0. 



_-_-_- = = = = -t'O o o s 



0) 0) 

o o 

SE 



L o List current line 

E . Edit current line 

BACKSPACE o - o o Backspace 

BREAK oooooooooooooo Stops, sets 

command mode 

CLEAR oooo Clear screen 

CLEAR ooo-ooo Clear and reset 64 

char mode 
CTRL J 0---0 Line feed 

without end 
CTRL o Toggle display 

function 

CTRL R o Retype current line 

CTRL U o Restart current 

line 
down arrow o Scroll down 

during list 
down arrow - o o - - o o o Line feed 

without end 
ENTER oooooooooooooo Terminates input 
HOLD o Halt display during 

execution 
F1, ENTER o Enter Edit mode for 

immediate line 
left arrow oooooooooooooo Backspace and 

delete character 
REPEAT o Repeat a 

single key 
right arrow -oo- -oo-ooo- - - Space to next tab 
SHIFT, ® -oo-ooooooo-- Halt display during 

execution 
PAUSE oo Halt display during 

execution 
SHIFT, oooo-- Toggle reverse or 

lower case 

SHIFT, down o List last program 

arrow line 



Key 



Description 



SHIFT, left 


1, LVL 1 
1, LVL II 

I, Disk 

II, 12 

III, LVL I 

III, LVL III (4, 41 
III, Disk (4, 4P) 
4, 4P, Disk 
CC, BASIC 
CC, Ext BASIC 
CC, Disk 
MC-10 
Model 100 
Model 100, Disk 




-00-0000000 


Delete line, return 


arrow 






SHIFT, right 


- OO - - 00 


Set 32-character 


arrow 




mode 


SHIFT, up 





List first program 


arrow 




line 


space bar 


oooooooooooooo 


Blank 


TAB 


o 00 


Space to next tab 


up arrow 


o o 


Halt display during 
execution 


up arrow 


o o-o 


Scroll up during 
list 



Error Codes 



Configuration 



ST H 



^ v 



o 



* 3T O — — 



^ .— v *" 



_ •» " 

- = rig 

> > £ ffl UJ D . _ 

_i j Q . . . ■ X) 

_-_-_- O O O O 

= E = = OOOS 



•o 

S s Mnem. 



Description 



111111*** 


* 1 1 


NF 


NEXT without 
FOR 


2 2 2 2 2 2*** 


* 2 2 


SN 


Syntax error 


3 3 3 3 3 3*** 


* 3 3 


RG 


RETURN 
without 
GOSUB 


4 4 4 4 4 4*** 


* 4 4 


00 


Out of DATA 


5 5 5 5 5 5*** 


* 5 5 


FC 


Illegal function 
call 


6 6 6 6 6 6*** 


* 6 6 


OU 


Overflow 


7 7 7 7 7 7 * * * 


* 7 7 


0M 


Out of memory 


8 8 8 8 8 8 * * * 


* 8 8 


UL 


Undefined line 


9 9 9 9 9 9 * * * 


* 9 9 


BS 


Subscript out 
of range 


10 1010 10 10 10 * * ' 


k * 10 10 


DD 


Redimensioned 
array 


11 11 11 11 1111 * * 


k * 11 11 


/O 


Division by 


12 12 12 12 12 12 * * 


' * 12 12 


ID 


Illegal direct 


13 13 13 13 1313 * * 


* * 13 13 


TM 


Type mismatch 


14 14 14 14 14 14 * * 


* * 14 14 


OS 


Out of string 
space 


15 15 15 15 15 15 * * 


* * 15 15 


LS 


String too long 


16 16 16 16 16 16 * * 


* * 16 16 


SI 


String too 
complex 


17 17 17 17 17 17 * * 


* * 17 17 


CN 


Can't continue 






UF 


Undefined user 
function 


18 18 19 181819 - - 


- - 1919 


NR 


No RESUME 


19 19 20 19 19 20 - - 


- - 20 20 


KW 


RESUME 
without error 


20 20 21 20 20 21 - - 


- - 21 21 


UE 


Unprintable 
error 


21 21 22 21 21 22 - - 


- - 22 22 


M0 


Missing 
operand 


22 22 - 22 22 - * * 


* _ _. — 


FD 


Bad file data 



Error Codes 

Configuration 



a )£ 



*? ^ 



— S — Si 
_i % < X 

> > ~ CD UJ 



.2 d j 3 D . . „ . w 
Q ^ - . - O O O O O 
_r= = = = OGOS2 



Mnem. Description 



- - 23 - - 23 
23 - - 23 - - 



B0 
L3 



26 - 



29 

30 

50 50 - 51 50 

51 51 - 52 51 

52 52 - 53 52 

53 53 - 54 53 

54 54 - 55 54 
- 55 - - 55 



- - F0 

50 50 IE 

51 51 BN 

52 52 FF 

- - BM 

53 53 A0 



58 CF 

- 57 56 - 58 57 10 

57 FL 

- - 57 FE 

_ _ 5 8 _ _ UE 

59 AT 

60 DN 

61 TS 

- 61 59 - 62 61 - - * - - 63 DF 

- 62 60 - 63 62 54 54 EF 

- 63 61 - 64 63 RN 

__62 NM 



Buffer overflow 
Disk BASIC 

only 
FOR without 

NEXT 
WHILE without 

WEND 
WEND without 

WHILE 
Field overflow 
Internal error 
Bad file 

number 
File not found 
Bad file mode 
File already 

open 
File not open 
Disk I/O error 
Undefined error 
Undefined Mod 

II BASIC 
Undefined error 
Bad allocation 

table 
Bad drive 

number 
Bad Track/ 

Sector 
Oisk full 
Input past end 
Bad record 

number 
Undefined Mod 

II BASIC 



Error Codes 

Configuration 



<f j O ,2 

<£"»</> 5 

- *. — m ° o 

_ = ^ 0) **■ ,* oo 

J Q _-_-_- O O O O o o „ 

_-_-= = = = 000522 Mnem. 

--63 MM 

- - 64 UE 

- 64 - - 65 64 55 55 

- 66 65 - 67 66 * * * - 56 56 DS 



66 



FL 



67 
68 

69 



- 68 67 

- 69 - 



70 



58 



AE 



- - BR 

- - DN 

- - ER 

- - FM 

- - FN 

- - FS 

- - IE 

18 18 10 

- - NE 

- - NO 

- - OB 



Description 

Mode mismatch 
Undefined error 
Bad filename 
Direct 

statement 

in file 
Undefined Mod 

II BASIC 
Too many files 
Disk write 

protected 
File access 

denied 
File already 

exists 
Bad record 

number 
Device number 

error 
I/O past end of 

record 
Bad file mode 
Bad file name 
Bad file 

structure 
Input past end 

of file 
I/O error 
Can't find disk 

file 
File not open 
Out of buffer 

space 



Error Codes 

Configuration 



= « =* 

CO 

< 



-I _1 



U 

55 

< 

DO 



> > ~ m lu o 



« J J D 



o o o 
o o o 



6 S 



5 Mnem. Description 



SE 



VF 
WP 



Set to 

non-fielded 

string 
Verification 

error 
Write protected 



r 



Common ASCII Characters Used in BASIC 



CHAR 

space 

i 



DEC 



HEX 



> 

9 

@ 

A 

B 

C 

D 

E 

F 

G 

H 

I 

J 

K 

L 

M 



32 


20 


33 


21 


34 


22 


35 


23 


36 


24 


37 


25 


38 


26 


39 


27 


40 


28 


41 


29 


42 


2A 


43 


2B 


44 


2C 


45 


2D 


46 


2E 


47 


2F 


48 


30 


49 


31 


50 


32 


51 


33 


52 


34 


53 


35 


54 


36 


55 


37 


56 


38 


57 


39 


58 


3A 


59 


3B 


60 


3C 


61 


3D 


62 


3E 


63 


3F 


64 


40 


65 


41 


66 


42 


67 


43 


68 


44 


69 


45 


70 


46 


71 


47 


72 


48 


73 


49 


74 


4A 


75 


4B 


76 


4C 


77 


4D 



CHAR 


DEC 


HE} 


N 


78 


4E 





79 


4F 


P 


80 


50 


Q 


81 


51 


R 


82 


52 


S 


83 


53 


T 


84 


54 


U 


85 


55 


V 


86 


56 


W 


87 


57 


X 


88 


58 


Y 


89 


59 


Z 


90 


5A 




91 


5B 




92 


5C 




93 


5D 




94 


5E 




95 


5F 




96 


60 


a 


97 


61 


b 


98 


62 


c 


99 


63 


d 


100 


64 


e 


101 


65 


f 


102 


66 


g 


103 


67 


h 


104 


68 


i 


105 


69 


J 


106 


6A 


k 


107 


6B 


I 


108 


6C 


m 


109 


6D 


n 


110 


6E 





111 


6F 


P 


112 


70 


q 


113 


71 


r 


114 


72 


s 


115 


73 


t 


116 


74 


u 


117 


75 


V 


118 


76 


w 


119 


77 


X 


120 


78 


y 


121 


79 


z 


122 


7A 




123 


7B 




124 


7C 




125 


7D 




126 


7E 




127 


7F 



Decimal/Binary/Octal/ 
Hexadecimal Conversions 



DEC 


BIN 


OCT 


HEX 





00000000 


000 


00 


1 


00000001 


001 


01 


2 


00000010 


002 


02 


3 


0000001 1 


003 


03 


4 


00000100 


004 


04 


5 


00000101 


005 


05 


6 


00000110 


006 


06 


7 


00000111 


007 


07 


8 


00001000 


010 


08 


9 


00001001 


011 


09 


10 


00001010 


012 


0A 


11 


00001011 


013 


0B 


12 


00001100 


014 


OC 


13 


00001101 


015 


0D 


14 


00001110 


016 


OE 


15 


00001 1 1 1 


017 


OF 


16 


00010000 


020 


10 


17 


00010001 


021 


11 


18 


00010010 


022 


12 


19 


00010011 


023 


13 


20 


00010100 


024 


14 


21 


00010101 


025 


15 


22 


00010110 


026 


16 


23 


00010111 


027 


17 


24 


00011000 


030 


18 


25 


00011001 


031 


19 


26 


00011010 


032 


1A 


27 


00011011 


033 


1B 


28 


00011100 


034 


1C 


29 


00011101 


035 


1D 


30 


00011110 


036 


1E 


31 


00011111 


037 


1F 


32 


00100000 


040 


20 


33 


00100001 


041 


21 


34 


00100010 


042 


22 


35 


00100011 


043 


23 


36 


00100100 


044 


24 


37 


00100101 


045 


25 


38 


00100110 


046 


26 


39 


00100111 


047 


27 


40 


00101000 


050 


28 


41 


00101001 


051 


29 


42 


00101010 


052 


2A 



DEC 



BIN 



OCT HEX 



43 


00101011 


053 


2B 


44 


00101100 


054 


2C 


45 


00101101 


055 


2D 


46 


00101110 


056 


2E 


47 


00101111 


057 


2F 


48 


00110000 


060 


30 


49 


00110001 


061 


31 


50 


00110010 


062 


32 


51 


00110011 


063 


33 


52 


00110100 


064 


34 


53 


00110101 


065 


35 


54 


00110110 


066 


36 


55 


00110111 


067 


37 


56 


00111000 


070 


38 


57 


00111001 


071 


39 


58 


00111010 


072 


3A 


59 


00111011 


073 


3B 


60 


00111100 


074 


3C 


61 


00111101 


075 


3D 


62 


00111110 


076 


3E 


63 


00111111 


077 


3F 


64 


01000000 


100 


40 


65 


01000001 


101 


41 


66 


01000010 


102 


42 


67 


01000011 


103 


43 


68 


01000100 


104 


44 


69 


01000101 


105 


45 


70 


01000110 


106 


46 


71 


01000111 


107 


47 


72 


01001000 


110 


48 


73 


01001001 


111 


49 


74 


01001010 


112 


4A 


75 


01001011 


113 


4B 


76 


01001100 


114 


4C 


77 


01001101 


115 


4D 


78 


01001110 


116 


4E 


79 


01001111 


117 


4F 


80 


01010000 


120 


50 


81 


01010001 


121 


51 


82 


01010010 


122 


52 


83 


01010011 


123 


53 


84 


01010100 


124 


54 


85 


01010101 


125 


55 


86 


01010110 


126 


56 


87 


01010111 


127 


57 


88 


01011000 


130 


58 



DEC 



BIN 



OCT HEX 



89 


01011001 


131 


59 


90 


01011010 


132 


5A 


91 


01011011 


133 


5B 


92 


01011100 


134 


5C 


93 


01011101 


135 


5D 


94 


01011110 


136 


5E 


95 


01011111 


137 


5F 


96 


01100000 


140 


60 


97 


01100001 


141 


61 


98 


01100010 


142 


62 


99 


01100011 


143 


63 


100 


01100100 


144 


64 


101 


01100101 


145 


65 


102 


01100110 


146 


66 


103 


01100111 


147 


67 


104 


01101000 


150 


68 


105 


01101001 


151 


69 


106 


01101010 


152 


6A 


107 


01101011 


153 


6B 


108 


01101100 


154 


6C 


109 


01101101 


155 


6D 


110 


01101110 


156 


6E 


111 


01101111 


157 


6F 


112 


01110000 


160 


70 


113 


01110001 


161 


71 


114 


01110010 


162 


72 


115 


01110011 


163 


73 


116 


01110100 


164 


74 


117 


01110101 


165 


75 


118 


01110110 


166 


76 


119 


01110111 


167 


77 


120 


01111000 


170 


78 


121 


01111001 


171 


79 


122 


01111010 


172 


7A 


123 


01111011 


173 


7B 


124 


01111100 


174 


7C 


125 


01111101 


175 


7D 


126 


01111110 


176 


7E 


127 


01111111 


177 


7F 


128 


10000000 


200 


80 


129 


10000001 


201 


81 


130 


10000010 


202 


82 


131 


10000011 


203 


83 


132 


10000100 


204 


84 


133 


10000101 


205 


85 


134 


10000110 


206 


86 



DEC 


BIN 


OCT 


HEX 


135 


10000111 


207 


87 


136 


10001000 


210 


88 


137 


10001001 


211 


89 


138 


10001010 


212 


8A 


139 


10001011 


213 


8B 


140 


10001100 


214 


8C 


141 


10001101 


215 


8D 


142 


10001110 


216 


8E 


143 


10001111 


217 


8F 


144 


10010000 


220 


90 


145 


10010001 


221 


91 


146 


10010010 


222 


92 


147 


10010011 


223 


93 


148 


10010100 


224 


94 


149 


10010101 


225 


95 


150 


10010110 


226 


96 


151 


10010111 


227 


97 


152 


10011000 


230 


98 


153 


10011001 


231 


99 


154 


10011010 


232 


9A 


155 


10011011 


233 


9B 


156 


10011100 


234 


9C 


157 


10011101 


235 


9D 


158 


10011110 


236 


9E 


159 


10011111 


237 


9F 


160 


10100000 


240 


A0 


161 


10100001 


241 


A1 


162 


10100010 


242 


A2 


163 


10100011 


243 


A3 


164 


10100100 


244 


A4 


165 


10100101 


245 


A5 


166 


10100110 


246 


A6 


167 


10100111 


247 


A7 


168 


10101000 


250 


A8 


169 


10101001 


251 


A9 


170 


10101010 


252 


AA 


171 


10101011 


253 


AB 


172 


10101100 


254 


AC 


173 


10101101 


255 


AD 


174 


10101110 


256 


AE 


175 


10101111 


257 


AF 


176 


10110000 


260 


BO 


177 


10110001 


261 


B1 


178 


10110010 


262 


B2 


179 


10110011 


263 


B3 


180 


10110100 


264 


B4 



3EC 


BIN 


OCT 


HEX 


181 


10110101 


265 


B5 


182 


10110110 


266 


B6 


183 


10110111 


267 


B7 


184 


10111000 


270 


B8 


185 


10111001 


271 


B9 


186 


10111010 


272 


BA 


187 


10111011 


273 


BB 


188 


10111100 


274 


BC 


189 


10111101 


275 


BD 


190 


10111110 


276 


BE 


191 


10111111 


277 


BF 


192 


11000000 


300 


CO 


193 


11000001 


301 


C1 


194 


11000010 


302 


C2 


195 


11000011 


303 


C3 


196 


11000100 


304 


C4 


197 


11000101 


305 


C5 


198 


11000110 


306 


C6 


199 


11000111 


307 


C7 


200 


11001000 


310 


C8 


201 


11001001 


311 


C9 


202 


11001010 


312 


CA 


203 


11001011 


313 


CB 


204 


11001100 


314 


CC 


205 


11001101 


315 


CD 


206 


11001110 


316 


CE 


207 


11001111 


317 


CF 


208 


11010000 


320 


DO 


209 


11010001 


321 


D1 


210 


11010010 


322 


D2 


211 


11010011 


323 


D3 


212 


11010100 


324 


D4 


213 


11010101 


325 


D5 


214 


11010110 


326 


D6 


215 


11010111 


327 


D7 


216 


11011000 


330 


D8 


217 


11011001 


331 


D9 


218 


11011010 


332 


DA 


219 


11011011 


333 


DB 


220 


11011100 


334 


DC 


221 


11011101 


335 


DD 


222 


11011110 


336 


DE 


223 


11011111 


337 


DF 


224 


11100000 


340 


EO 


225 


11100001 


341 


E1 


226 


11100010 


342 


E2 



DEC 



BIN 



OCT HEX 



227 


11100011 


343 


E3 


228 


11100100 


344 


E4 


229 


11100101 


345 


E5 


230 


11100110 


346 


E6 


231 


11100111 


347 


E7 


232 


11101000 


350 


E8 


233 


11101001 


351 


E9 


234 


11101010 


352 


EA 


235 


11101011 


353 


EB 


236 


11101100 


354 


EC 


237 


11101101 


355 


ED 


238 


11101110 


356 


EE 


239 


11101111 


357 


EF 


240 


11110000 


360 


FO 


241 


11110001 


361 


F1 


242 


11110010 


362 


F2 


243 


11110011 


363 


F3 


244 


11110100 


364 


F4 


245 


11110101 


365 


F5 


246 


11110110 


366 


F6 


247 


11110111 


367 


F7 


248 


11111000 


370 


F8 


249 


11111001 


371 


F9 


250 


11111010 


372 


FA 


251 


11111011 


373 


FB 


252 


11111100 


374 


FC 


253 


11111101 


375 


FD 


254 


11111110 


376 


FE 


255 


11111111 


377 


FF 



